Driver FixRecommendedSound, Wi-Fi or graphics acting up? Check drivers firstFind missing or outdated drivers fast.Check DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsPC HealthRecommendedCrashes, freezes, slowdowns? Check your PC nowSpot repairable issues before they interrupt work.Check PC×
Skip to content
World desk2 min

How to Load the Omniston Widget with @ston-fi/omniston-widget-loader

Load the Omniston widget with the npm loader, configure TON Connect, and mount it into a page element. Choose standalone or integrated mode to suit your app.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Install @ston-fi/omniston-widget-loader, await its load() method, configure TON Connect, then mount the widget into an existing DOM element. Choose standalone mode if the widget should manage its own connection, or integrated mode to reuse your app’s TON Connect instance.

Install the loader and add a mount point

Use the package manager already used by your application. The STON.fi guide supports npm, yarn, and pnpm:

As an Amazon Associate I earn from qualifying purchases.

npm install @ston-fi/omniston-widget-loader
yarn add @ston-fi/omniston-widget-loader
pnpm add @ston-fi/omniston-widget-loader

If the application does not already depend on TON Connect, install @tonconnect/sdk as well. An existing TON Connect integration can be reused instead. STON.fi’s widget guide describes a framework-agnostic integration for environments that can host DOM nodes, including static sites and Vue, Angular, and Svelte apps.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Add a container to the page before mounting the widget:

#1 Best Overall
Sale
HTML and CSS: Design and Build Websites
  • HTML CSS Design and Build Web Sites
  • Comes with secure packaging
  • It can be a gift option
<div id="omniston-widget-container"></div>

Load and mount the widget in standalone mode

In standalone mode, the widget initializes TON Connect using your application’s manifest. The manifest must be created and hosted by the integrator. STON.fi’s guide says its URL must be on the same domain as the application because wallets reject connections when the domains do not match.

import OmnistonWidgetLoader from '@ston-fi/omniston-widget-loader';

const OmnistonWidget = await OmnistonWidgetLoader.load();
const widget = new OmnistonWidget({
  tonconnect: {
    type: 'standalone',
    options: {
      manifestUrl: 'https://YOUR_APP_HOST/tonconnect-manifest.json',
    },
  },
});

widget.mount(document.querySelector('#omniston-widget-container'));

Replace YOUR_APP_HOST with the host serving your application and manifest. Ensure the container exists before mount() runs; otherwise the widget has no DOM target. The guide says the widget loads its own styles, so a separate CSS import is not required.

Rank #2
Sale
Web Design with HTML, CSS, JavaScript and jQuery Set
  • Brand: Wiley
  • Set of 2 Volumes
  • A handy two-book set that uniquely combines related technologies Highly visual format and accessible language makes these books highly effective learning tools Perfect for beginning web designers and front-end developers

Reuse an existing TON Connect instance

If your app already initializes TON Connect, pass that instance in integrated mode. This lets the widget share the connection managed by the host application.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
import { TonConnect } from '@tonconnect/sdk';
import OmnistonWidgetLoader from '@ston-fi/omniston-widget-loader';

const tonconnect = new TonConnect({
  manifestUrl: 'https://YOUR_APP_HOST/tonconnect-manifest.json',
});
const OmnistonWidget = await OmnistonWidgetLoader.load();
const widget = new OmnistonWidget({
  tonconnect: {
    type: 'integrated',
    instance: tonconnect,
  },
});

widget.mount(document.querySelector('#omniston-widget-container'));

Use the current widget guide and official repository for exact types and lifecycle details as the API may change.

Choose the loading approach that fits your app

Approach How it works Best fit
npm loader Import @ston-fi/omniston-widget-loader and call load(); the package fetches the widget bundle from STON.fi’s CDN at runtime. Bundled JavaScript apps that need programmatic control over when widget assets load.
Direct CDN script Include https://widget.ston.fi/v0/index.js; browser code can then construct and mount window.OmnistonWidget. Static pages or build-free experiments.

STON.fi documents major-versioned CDN paths such as /v0/ and /v1/. Its stated distribution policy is to deliver non-breaking updates within a major version and require a new major path for breaking changes. Treat that as the vendor’s policy, not an independent guarantee of future compatibility. See the repository README and guide for current integration details.

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Optional widget configuration

The widget guide and visual constructor document options beyond the connection setup:

  • Theme and token assets: configure the appearance and use default or custom token assets.
  • Referral settings: the guide documents a configurable referral wallet address and fee field ranging from 0% to 1.0%. This range describes the available setting, not a typical fee or a promise of earnings.

Use the widget guide and visual constructor to check the current configuration options before adding them to your implementation.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Quick Recap

SaleBestseller No. 1
HTML and CSS: Design and Build Websites
HTML and CSS: Design and Build Websites
HTML CSS Design and Build Web Sites; Comes with secure packaging; It can be a gift option
$14.94
SaleBestseller No. 2
Web Design with HTML, CSS, JavaScript and jQuery Set
Web Design with HTML, CSS, JavaScript and jQuery Set
Brand: Wiley; Set of 2 Volumes
$35.05
SaleBestseller No. 3
SaleBestseller No. 5
JavaScript and jQuery: Interactive Front-End Web Development
JavaScript and jQuery: Interactive Front-End Web Development
JavaScript Jquery; Introduces core programming concepts in JavaScript and jQuery; Uses clear descriptions, inspiring examples, and easy-to-follow diagrams
$22.28
Best Value
Sale
JavaScript and jQuery: Interactive Front-End Web Development
  • JavaScript Jquery
  • Introduces core programming concepts in JavaScript and jQuery
  • Uses clear descriptions, inspiring examples, and easy-to-follow diagrams

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Crashes, No Sound, or Screen Glitches?Free driver scan
PC Slower Than It Used to Be?Free scan - under a minute

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.