Quickstart

​

1. Install the CLI and scaffold an app

bun add -g @sentralbee/cli
sentralbee create my-app
cd my-app

bun install

​

2. Look around

sentralbee.app.json     your manifest: provider, scopes, embed, webhooks, optional checkout
api/src/app.ts          the Hono app — ADD YOUR FEATURES HERE (install lifecycle + /api/* + webhooks)
api/src/config.ts       builds the SDK verifier + cypher from env
api/src/store.ts        a tiny bun:sqlite store (encrypted api key + config per workspace)
ui/src/App.tsx          your React embed, using @sentralbee/app-sdk/react hooks
AGENTS.md               a guide for AI agents (and you) on how to extend the app

​

3. Run it

bun run dev

1. generates a throwaway dev keypair and starts your app with the matching public key,
2. mock-installs a workspace — delivering a fake API key (and webhook secret) to /install/provision, exactly as the real platform would,
3. prints an embed URL carrying a live session token.

▸ "my-app" (aud: my-app)
✓ provisioned dev workspace
  Embed  →  http://localhost:8080/?token=…&theme=light
  Event  →  sentralbee webhook order.paid
  Token  →  sentralbee token

​

4. Exercise the pieces

sentralbee webhook order.paid      # fires a signed webhook at your app → your handler runs
sentralbee token                   # prints a fresh session token + embed URL
sentralbee manifest                # validates sentralbee.app.json

​

5. Build your app

• Add an endpoint — add a route to the api Hono instance in api/src/app.ts. It’s session-authed, so read the tenant with c.get('workspace'), never from the request body.
• Call Sentralbee — decrypt your stored key and use sentralbeeClient; see Calling the API.
• Handle webhooks — declare events in your manifest and verify with verifyWebhookSignature; see Webhooks.
• Request permissions — edit sentralbee.app.json → scopes; see The manifest.
• Build your UI — edit ui/src/App.tsx with the useHostTheme / useSafeArea / useSessionToken hooks; see The embed UI.

​

Where to next

• Concepts & lifecycle — the trust model and what happens on install.
• Install lifecycle — provisioning and teardown in detail.
• Publishing — when it’s ready, get it into the App Store.