Commands and paths >> Wild HQ handbook

Read the repository instructions and the current task before using this page. Commands below are non-production unless their warning says otherwise.

The authoritative published reference for the current Packbase SDK and REST API is docs-sdk.packbase.app.

Wild HQ site

Need	Command or path
Install	`pnpm install --frozen-lockfile`
Start background dev server	`pnpm exec astro dev --background`
Server state	`pnpm exec astro dev status`
Server logs	`pnpm exec astro dev logs`
Stop server	`pnpm exec astro dev stop`
Type and content diagnostics	`pnpm check`
Production build	`pnpm build`
Handbook source	`src/content/handbook/pages`
Handbook topics	`src/content/handbook-tags.yml`
Instinct source	`src/content/instincts`
Site identity and contact	`src/data/site.ts`
Operational governance notice	`src/data/siteStatus.ts`

Packbase web

The current repository declares a pnpm lockfile but invokes Bun inside some scripts. Install with the locked pnpm dependency graph and run current scripts with Bun.

Need	Command or path
Install	`pnpm install --frozen-lockfile`
Development app	`bun run dev`
Storybook	`bun run storybook`
Full readiness suite	`bun run check`
Lint	`bun run lint`
Types	`bun run typecheck`
Non-writing format check	`bun run format:check`
Tests, including Storybook Chromium project	`bun run test`
Build application	`bun run build`
Build Storybook	`bun run build-storybook`
Extract Lingui messages	`bun run lingui:extract`
Cloudflare preview	`bun run preview`
Cloudflare deploy	`bun run deploy` — production authority required
Routes	`src/routes`
Generated route tree	`src/routeTree.gen.ts` — do not edit
Shared UI	`src/components/ui`
Feature UI	`src/components/<feature>`
Packbase hooks	`src/hooks/packbase`
Stable hook exports	`src/hooks/use-packbase.ts`
Locales	`src/locales/{locale}`
Cloudflare Worker	`worker/index.ts`

Packbase server

Run these from the packbase repository root.

Need	Command or path
Install	`pnpm install --frozen-lockfile`
Development server	`pnpm --dir apps/server dev`
Production-style process	`pnpm --dir apps/server start` — use an identified environment
Validate route table	`pnpm --dir apps/server routes:check`
Print route table	`pnpm --dir apps/server routes:list`
Update intentional path snapshot	`pnpm --dir apps/server routes:snapshot`
Typecheck	`pnpm --dir apps/server check-types`
Tests	`pnpm --dir apps/server test`
Lint	`pnpm --dir apps/server lint`
Non-writing format check	`pnpm --dir apps/server format:check`
Generate Prisma client	`pnpm --dir apps/server prisma:generate`
Sync a named disposable database	`pnpm --dir apps/server prisma:push` — mutating
Destructive schema push	`pnpm --dir apps/server migrate` — accepts data loss and omits SQL migration deployment; never a complete release procedure by itself
Server entry	`apps/server/src/index.ts`
Route registry	`apps/server/src/routes/index.ts`
HTTP core	`apps/server/src/http`
Domain routes	`apps/server/src/routes/<domain>`
Domain schemas	`apps/server/prisma/schema`
Boot-time data work	`apps/server/src/db/run-on-boot`
Background jobs	`apps/server/src/lib`
Example environment names	`apps/server/.env.example`

Git quick check

Before editing or formatting in any checkout:

git status --short

Before hand-off:

git diff --check

These commands do not replace repository tests or review.