CrabStack docs

A NestJS backend (PostgreSQL via Knex), a Next.js 16 frontend, and one REST + OpenAPI contract tying them together.

What this template is, what it deliberately leaves out, how to install it and how to run the seed data are all in the README. Start there; these pages assume it.

The pages

• Architecture - how the two halves connect, the module layout on both sides, the REST surface, guards, worker recovery, and what account deletion erases.
• Auth Flow - OAuth and magic-link sign-in, session validation, and how Server Components and Server Actions get a session.
• Adding a Module - the full walkthrough for a new feature module, migration through typed frontend page.
• Admin MCP Server - the AI-agent interface to a deployed app, plus the OAuth flow browser-based clients need.
• Email - the two send paths: synchronous magic links and the backend queue.
• Billing - Stripe checkout, the webhook state machine, entitlement gating, and swapping in another processor.
• Environment Variables - every variable both halves read, and which ones fail boot in production.
• Deployment - VPS or any host, with a pre-launch checklist.

The changelog is worth reading before a git merge upstream: it carries the changes that merge cleanly and then behave differently.