OneNess widget center

A floating wallet button with the OneNess ring logo and the LIVE synced promo feed inside β€” public to any origin, dependency-free, shadow-DOM isolated. Copy the snippet for your stack below; they all mount the same widget and stay in sync with every user's wallet.

🩹Get the button β€” universal one-liner


    
Open a live demo site β†— …or this very page: the widget is mounted bottom-right, try it.

Configuration (script attributes β€” or window.OneNessWidgetConfig)

data-baseBase URL of the OneNess deployment. Default: this origin. Self-hosters point it anywhere.
data-posCorner: br (default) Β· bl Β· tl Β· tr
data-modelink = buttons open vault pages in a new tab (default) Β· embed = pages open inside the panel's iframe
JS APIOneNessWidget.open() Β· close() Β· refresh() Β· setBase(url)

Sync guarantee: the panel reads GET /api/promo/feed β€” one public, CORS-open, no-store feed. Paid banner rotation is wall-clock-derived, so every user of every surface sees the same banner during the same 6-second slot; promo changes reach every embedded widget and the Chrome/Edge extension within one poll (≀60 s).

Pick your language fresh snippets in 20+ stacks

` }, {/* ==== PYTHON ==== */} { name: 'Python β€” Flask', lang: 'python', group: 'Python', text: b => `# OneNess widget on every Flask page β€” put in base template from flask import Flask, render_template app = Flask(__name__) WIDGET_SNIPPET = """ """ @app.context_processor def oneness_widget(): return dict(oneness_widget_snippet=WIDGET_SNIPPET) # templates/base.html: {{ oneness_widget_snippet|safe }} just before ` }, { name: 'Python β€” Django', lang: 'python', group: 'Python', text: b => `{# templates/base.html β€” OneNess widget on every page #} ` }, { name: 'Python β€” FastAPI', lang: 'python', group: 'Python', text: b => `# OneNess widget β€” a whole embeddable page via FastAPI from fastapi import FastAPI from fastapi.responses import HTMLResponse app = FastAPI() @app.get("/", response_class=HTMLResponse) def home(): return f"""

My app

"""` }, { name: 'Python β€” Jinja2 macro', lang: 'jinja', group: 'Python', text: b => `{# oneness/macros.html #} {% macro oneness_widget(base="${b}") -%} {%- endmacro %} {# usage in any template: {{ oneness_widget() }} #}` }, {/* ==== SERVER-SIDE CLASSIC ==== */} { name: 'PHP (raw)', lang: 'php', group: 'Server-side', text: b => `';` }, { name: 'WordPress (shortcode + enqueue)', lang: 'php', group: 'Server-side', text: b => ` 'defer', 'in_footer' => true ]); wp_localize_script('oneness-widget', 'OneNessWidgetConfig', [ 'base' => $base ]); }); /* Optional shortcode: [oneness_widget_open] add_shortcode('oneness_widget_open', function () { return 'Open OneNess'; }); */` }, { name: 'Laravel (Blade)', lang: 'blade', group: 'Server-side', text: b => `{{-- resources/views/layouts/app.blade.php β€” before --}} ` }, { name: 'Ruby on Rails (ERB)', lang: 'erb', group: 'Server-side', text: b => `<%# app/views/layouts/application.html.erb β€” before %> <%= tag.script defer: true, src: "${b}/widget/oneness-widget.js", data: { base: "${b}" } %>` }, { name: 'Java β€” JSP', lang: 'jsp', group: 'Server-side', text: b => `<%-- footer.jsp --%> ` }, { name: 'Java β€” Thymeleaf', lang: 'html', group: 'Server-side', text: b => ` ` }, { name: 'C# β€” ASP.NET (Razor)', lang: 'razor', group: 'Server-side', text: b => `@* Views/Shared/_Layout.cshtml β€” before *@ @* Or hardcode the base: *@` }, { name: 'Go (html/template)', lang: 'go', group: 'Server-side', text: b => `{{/* footer.tmpl */}} {{/* handler.go β€” no escaping surprises, the constants are safe base := "${b}" tmpl.ExecuteTemplate(w, "footer.tmpl", map[string]any{"Base": base}) */}}` }, {/* ==== MORE LANGUAGES & PLATFORMS ==== */} { name: 'Elixir Phoenix (HEEx)', lang: 'heex', group: 'Server-side', text: b => `<%# root.html.heex β€” before %> ` }, { name: 'Clojure (Hiccup)', lang: 'clojure', group: 'Server-side', text: b => `;; OneNess widget β€” hiccup in any template (defn oneness-widget [base] [:script {:defer true :src (str base "/widget/oneness-widget.js") :data-base base}]) ;; usage: (oneness-widget "${b}")` }, { name: 'Rust (Leptos)', lang: 'rust', group: 'Server-side', text: b => `// OneNess widget β€” inject via dangerously_set_inner_html use leptos::*; use leptos_dom::html::AnyElement; #[component] fn OnenessWidget(base: String) -> impl IntoView { let html = r#""# .to_string().replace("BASE", base.as_str()); view! { } } // usage: view! { }` }, { name: 'Shopify (Liquid)', lang: 'liquid', group: 'Server-side', text: b => `{% comment %} theme.liquid β€” before {% endcomment %} ` }, { name: 'Dart / Flutter (WebView)', lang: 'dart', group: 'Mobile & desktop', text: b => `// OneNess widget β€” open the wallet overlay in-flutter (webview_flutter) import 'package:flutter/material.dart'; import 'package:webview_flutter/webview_flutter.dart'; class OnenessOverlay extends StatelessWidget { final String base = '${b}'; @override Widget build(BuildContext context) { final controller = WebViewController() ..setJavaScriptMode(JavaScriptMode.unrestricted) ..loadRequest(Uri.parse('\$base/widget/preview.html')); return Scaffold( appBar: AppBar(title: const Text('OneNess Wallet')), body: WebViewWidget(controller: controller), ); } }` }, { name: 'Android β€” Kotlin (WebView)', lang: 'kotlin', group: 'Mobile & desktop', text: b => `// OneNess widget β€” open the wallet in a WebView overlay class OneNessDialog(context: Context, base: String = "${b}") : Dialog(context) { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) val wv = WebView(context).apply { settings.javaScriptEnabled = true loadUrl("${b}/widget/preview.html") // pre-wired demo host } setContentView(wv) } } // usage: OneNessDialog(ctx).show()` }, { name: 'iOS β€” Swift (SwiftUI + WKWebView)', lang: 'swift', group: 'Mobile & desktop', text: b => `// OneNess widget β€” SwiftUI sheet with the wallet view import SwiftUI import WebKit struct OneNessSheet: View { var base = "${b}" var body: some View { WebViewRepresentable(url: URL(string: "\\(base)/widget/preview.html")!) } } struct WebViewRepresentable: UIViewRepresentable { let url: URL func makeUIView(context: Context) -> WKWebView { let wv = WKWebView(); wv.load(URLRequest(url: url)); return wv } func updateUIView(_ wv: WKWebView, context: Context) {} }` }, ]; /* ---- render the cards + filters + universal snippet + copy ----------------- */ const GROUPS = ['All', ...new Set(SNIPPETS.map(s => s.group))]; let activeGroup = 'All'; function renderFilters() { $('#filters').innerHTML = GROUPS.map(g => `${esc(g)}`).join(''); $$('#filters .chip').forEach(c => c.onclick = () => { activeGroup = c.dataset.g; renderFilters(); renderCards(); }); } function renderCards() { const rows = SNIPPETS.filter(s => activeGroup === 'All' || s.group === activeGroup); $('#snippets').innerHTML = rows.map((s, i) => { const code = s.text(BASE); return `

${esc(s.name)} ${esc(s.lang)} ${esc(s.group)}

${esc(code)}
`; }).join(''); $$('#snippets .cp').forEach(b => b.onclick = async () => { const s = SNIPPETS[Number(b.dataset.i)]; const ok = await navigator.clipboard.writeText(s.text(BASE)).then(() => true).catch(() => false); (ON.toast)((ok ? 'Copied the ' + s.name + ' snippet' : 'copy failed'), ok ? 'ok' : 'err'); }); } $('#universal-snippet').textContent = `