ONFIRE / HANDBOOK

Quick start

Start a local OnFire workspace with local D1 data.

Requirements

Node.js 22 or later
pnpm 12.3.4
A local Cloudflare Wrangler environment

Install and seed

Shell
git clone https://github.com/backrunner/onfire.gitcd onfirepnpm install --frozen-lockfilecp .dev.vars.example .dev.varscp .env.example .env.localopenssl rand -base64 48

Put the generated value in .dev.vars as AUTH_SECRET. Then initialize local D1:

Shell
pnpm db:migrate:localpnpm db:seedpnpm db:seed:tickets

Start the admin server first, then the customer server in a second terminal:

Shell
pnpm dev:tob       # http://localhost:3001pnpm dev:toc       # http://localhost:3000

The demo dashboard login is [email protected] / admin. pnpm db:reset deletes local D1 data before recreating the demo. Never use demo credentials in production.

Verify the setup

Shell
pnpm cf-typegen --checkpnpm lintpnpm testpnpm build:worker

Vectorize, external AI providers, Cloudflare Email, and notification services need a deployed or separately configured environment.