Getting started

Use Node 26.4.0 with fnm. The default Flue model is Kilo through the custom provider registration in the local backend.

Install

fnm install 26.4.0
fnm use 26.4.0
npm install

Configure secrets

Copy .env.example to .env and fill in the local values.

KILOCODE_API_KEY=...
KILOCODE_ORGANIZATION_ID=...
FLUE_AGENT_MODEL=kilocode/kilo/auto
GITHUB_TOKEN=...
GITHUB_LOGIN=...

Run the local dashboard

npm run dev

Open http://127.0.0.1:5173/ on the companion display.

Run the webapp

npm run webapp:dev

The Astro marketing/docs site runs separately from the local dashboard and deploys to Cloudflare.

Deploy neondeck.dev

npm run webapp:deploy

The Worker is configured in webapp/wrangler.jsonc with custom domains for neondeck.dev and www.neondeck.dev.