Before you start
- A React app built with Vite.
- Test keys from the Authbound dashboard. See Get API keys.
- The Authbound wallet with a test ID in it. See Test with a wallet.
Add your keys
.env
openssl rand -base64 32. The VITE_ values end up in the browser bundle, which is fine: publishable keys and policy IDs aren’t secret.Add the server
The Authbound router adds the routes the browser SDK calls: starting a verification and setting a session cookie when it succeeds.During development, have Vite forward
server.ts
/api to it so both run on the same origin:vite.config.ts
Try it
Start the server withnpx tsx --env-file=.env server.ts and the app with pnpm dev. Click Start Verification, scan the QR code with your wallet and approve the request. The page switches to “You’re verified”.
Next steps
Receive webhooks
Add a webhook route to the Express server and confirm results there.
Browser sessions
Session modes, several tabs, time limits and proxies.
How it works
Why access decisions belong on your server.
Station UI
For enabled organizations, useStationEntry, StationEntryDisplay and StationOperatorConsole from @authbound/react. The station UI guide explains token scopes and direct Gateway versus same-origin proxy mode.