The STON.fi widget turns any surface — a wallet, dashboard, game, or campaign page — into a full-featured swap flow powered by aggregated liquidity. It’s the same production-grade swap experience used in app.ston.fi, now available for seamless embedding anywhere. The STON.fi widget constructor lets teams configure this widget to match their brand, set defaults, add integrator fees, and export ready-to-drop code.
| In #STONchronicles we share the technical breakthroughs and product milestones that showcase our commitment to building the future of DeFi on TON. |
This STON.fi update pushes the stack toward a simple, concrete goal: take the same full-featured swap experience millions already use on app.ston.fi and make it instantly available everywhere else. The STON.fi widget is a complete swap form backed by the intellectual routing and execution, now packaged for fast, lightweight integration into any third-party app, site, or interface.
What the constructor does
This is a browser-based constructor that outputs a production-ready, branded STON.fi widget. Configure appearance, defaults, token availability, and referral fees, then export and embed anywhere.
What the STON.fi widget constructor lets you do:
- Embed and preview a full-featured swap form. Use the constructor to customize a swap form powered with Omniston intellectual routing. A non-coding team (e. g., product managers and founders) can preview a branded flow before developers wire it into production.
- Style it to fit your brand. Switch between light and dark, pick your colors, and tune the UI elements so the widget looks native in your product.
- Set smart defaults. Choose the default pair users see on open, extend the token list beyond app.ston.fi’s defaults, and set an integrator fee for swaps made through your widget.
- Export and ship. Copy the provided CSS and JS snippets or use a single HTML file and paste them into your project. That’s it: the widget is visually ready.
Why STON.fi widget matters
- For users
Swaps happen where decisions happen — wallets, dashboards, mini-apps, campaign pages. Consistent execution, predictable pricing via aggregated routing. - For builders
A drop-in component instead of a sprint of glue code. Themable via CSS, configurable via the constructor, embeddable via two snippets. Integrate STON.fi widget once, and your users always get the current swap experience. Improvements, new routing logic, and feature upgrades propagate automatically. - For the ecosystem
One maintained swap surface across TON means less duplicate work and more consistent UX. As new liquidity sources appear, every embedded widget benefits—no per-site rewrites.
Where it shines
- Dedicated Swap tab inside wallets and payment apps, keep the token list tight, default to a high-frequency pair
- Campaign microsites: pre-configured pairs + referral accounting
- Analytics dashboards: swap or rebalance without context switching
- Checkout moments in games/NFT flows: convert at point of need
- Communities / DAOs: pre-select the house token, show a clear route and estimate.
How to integrate STON.fi widget
- Read the integration 30-second guide and get started with the default configuration right away.
- Read a high-level guide for embedding swaps with STON.fi widget.
In short
STON.fi widget constructor cuts the integration tax to near zero. You style the widget, set sane defaults, add referral fees, export snippets — done.
- Users swap in-context with Omniston’s best-route pricing and interact with the latest version of the swap.
- Builders skip SDK/API plumbing; as Omniston evolves and new features roll out, the widget updates automatically.
The result compounds network-wide: more surfaces exposing the same aggregated liquidity, shipped faster.
