getting-started.mdx

title	Getting Started
description	Run TrickFire Tasks locally for the first time.

TrickFire Tasks is a Next.js app with a local SQLite database, sharing most of its stack with the dashboard - read Next.js & TypeScript alongside this page if you're new to either.

Prerequisites:

• Node.js (see .nvmrc)
• pnpm package manager
• A C++ build toolchain (for better-sqlite3)

pnpm install
cp .env.example .env.local
pnpm db:migrate
pnpm dev

Open http://localhost:3006.

Signing in locally

Sign-in is GitHub-only, gated to members of the trickfirerobotics org - there's no email/password fallback. To sign in locally you need a real GitHub App configured (see GitHub App Setup) with its OAuth callback pointed at http://localhost:3006/api/auth/callback/github.

Until you've signed in once, pnpm db:seed has nothing to attach a demo project to (every row needs a real createdBy user). Sign in first, then run it.

Everyday commands

pnpm check       # lint + format check + typecheck
pnpm test        # vitest
pnpm reconcile   # manually run the missed-webhook safety net