Build your app. Bring it to Tabs.#
A Tabs mini-app is an HTTPS web app you host. Tabs provides public identity, permission-controlled ATProto publishing, verified app sign-in, and native chat and payment review. You own your UI and backend.
Developer preview · Android · Bridge V1 · SDK 0.2.0
Start building · Browse the SDK · Download the kit
SDK 0.2.0 is available on npm:
npm install @tabschat/miniapp-sdk
The browser bootstrap connects your app to the hosted simulator. The hosted script also works with existing Bridge V1 apps and needs no npm update.
Build with an AI coding agent#
Give your agent a complete Tabs compatibility brief. Our copyable agent prompt covers the manifest, custom Lexicons, mobile design, permissions, backend sign-in, testing and review, with links to the relevant contracts. Use it to adapt an existing app or start a new one.
Developer tools#
- Host simulator: test public HTTPS apps on phone and folding screen sizes with simulated users and native prompts, or opt into a real Tabs account for approved live apps.
- App-package builder: create a manifest, edit Lexicon fields and download the complete package.
- Submit an app: discover your deployed package, resolve validation issues and send it for review.
Use the downloaded simulator for localhost apps. Online apps must allow framing by developers.tabschat.com and load the SDK browser bootstrap. The browser simulator does not replace testing in Tabs.
Your first app, running locally#
git clone https://github.com/tabschat-at/miniapp-sdk.git
cd miniapp-sdk
npm run dev
Open http://127.0.0.1:4173 and try Hello Tabs. The preview needs no account or
dependency installation. It uses fake identities and in-memory records; payment
requests always cancel. Real sign-in and record operations also work for approved apps in the hosted
simulator. Uploads, payments, wallet signing and chat opening require native Tabs.
Start small, add the capabilities you need#
| Build with | Learn how |
|---|---|
| Public identity and permission handling | Hello Tabs and permissions |
| Public app records and your own feed | Recipe Notebook and manifest schemas |
| Verified login and private file uploads | Own backend example |
| Native chat and payment review | Native actions example and API reference |
| Your own signed-record indexer | Own AppView example |
| Optional shared public queries | Tabs AppView |
The runtime is a dependency-free ES module with bundled TypeScript declarations.
Use any web framework or plain HTML and JavaScript. The npm package is
@tabschat/miniapp-sdk. Install it in your application:
npm install @tabschat/miniapp-sdk
import { getHost, describeError } from "@tabschat/miniapp-sdk";
button.onclick = async () => {
try {
const person = await getHost().identity.getSelf();
result.textContent = `@${person.handle}`;
} catch (error) {
result.textContent = describeError(error);
}
};
From preview to a Tabs listing#
Host your app over HTTPS, validate the manifest, and submit it for review. The submission tool discovers your manifest and Lexicons from links in the HTML head, validates the package and shows the requested permissions. Operator review and domain verification are required; there is no automatic approval or public sideload flow. Users choose which permissions to grant.
Check host compatibility before depending on a feature. Android is supported; iOS is deferred. This is a developer preview with no production SLA or promised review timeline.
Open SDK, focused scope#
The SDK, examples and these docs are published under AGPL-3.0-only. See the license and release notes. The public repository contains the developer kit; Tabs application implementation is maintained separately.