Skip to main content
Bily is an app store for the internet: one trusted place to install, govern, and evolve reusable web capabilities. Connect a site once, use the SDK for browser events, and use the API for authenticated server workflows. Installing a capability should feel like installing an app: review its permissions, configure it, enable it, and later update or revoke it from one place.

What is Bily?

See how installable capabilities, governance, first-party delivery, and extensibility fit together.

Install in minutes

Choose the one installation path that matches your website.

Track page views

Capture the initial page automatically and later SPA routes explicitly.

Track product activity

Send products, carts, checkouts, and completed orders with typed payloads.

Use the SDK reference

Review every exported method, event type, and payload type.

Build with the Bily API

Access scoped stores, analytics, integrations, and supported actions from trusted servers.

​
One product, two developer surfaces

The SDK is the browser contract. It installs Bily and sends page, commerce, and custom events. The API is the server contract. It authenticates your backend, applies organization and store boundaries, and exposes the Bily capabilities available to your account. Both surfaces keep the customer-facing integration stable while Bily capabilities improve over time.

​
Choose one installation path

HTML

Add the exact Bily script tag to a site that does not use an application bundler.

JavaScript

Initialize Bily from a browser application built with npm.

React

Mount one SDK integration inside your router.

Next.js

Initialize from one App Router client component.
Do not combine the raw script tag and @bilyai/js on the same website surface. Both installation paths load Bily, so combining them can duplicate the initial page view.

​
What the SDK handles

  • It preserves the exact script URL and every query parameter you copy from Bily.
  • It safely queues calls while Bily loads.
  • It generates an event ID and timestamp when you do not provide them.
  • It gives known Bily events autocomplete while accepting your own event names.
  • It remains safe to import during server rendering.

Start with the quickstart

Install Bily and verify your first event.