Self-host

Trackstage is MIT-licensed and runs on a free Convex backend — about five minutes from clone to a working app.

Clone it and install.

Terminal

git clone https://github.com/markokraemer/trackstage
cd trackstage
pnpm install

Provision your backend. This opens a browser once to sign you in to Convex, then writes the connection into .env.local.
Terminal
```
pnpm dev:setup   # signs you in to Convex and provisions a free backend
```

Start it. Seeding is optional — it fills the app with a demo event so you have something to click.

Terminal

pnpm dev                          # http://localhost:3000
pnpm exec convex run seed:setup   # optional: demo event + organizer login

Deploy when you are ready. One command pushes the Convex backend and the Cloudflare Workers frontend.
Terminal
```
pnpm deploy   # Convex backend + Cloudflare Workers frontend
```

Optional settings

Set these on your Convex deployment. Everything works without them.

RESEND_API_KEY
Sends real email. Without it, every message is written to the outbox instead.
SITE_URL
Your app's public origin. Required for MCP OAuth and for links inside emails.
PUBLIC_API_TOKEN
The bearer token the read-only HTTP API accepts.
OPENROUTER_API_KEY
Turns the AI copilot on.

Your own deployment gets the same API and MCP server — point them at your host instead of the demo one.