Documentation
Everything you need to build, theme, and deploy on ShockStack. Opinionated conventions, zero-config where it counts, and escape hatches where it matters.
Get started
Install, orient, and make your first change.
Design system
Tokens, themes, and the component library.
Design Tokens
How the token pipeline works, how to edit tokens, and how they flow through to Tailwind and CSS.
Theming
The 19 built-in themes, runtime switching, and how to add your own palette.
Component Library
The set of Astro and Vue components that ship with ShockStack — what they do, when to reach for them, and how to build your own.
Build
Frontend, backend, auth, and data.
Frontend Guide
Frontend rendering strategy, component boundaries, content model, and route behavior.
Backend Guide
Clean architecture backend structure, request lifecycle, and development workflow.
Authentication
Session-based authentication flow, route protection, and extension points.
Database Guide
Drizzle ORM schema, migrations, seeding, and querying Postgres from Astro.
Ship & operate
Deployment, testing, and team conventions.
Deployment
Deploy the frontend to Cloudflare Workers, run the full stack in Docker, and wire up the release pipeline.
Testing Guide
Vitest for frontend + CLI, xUnit for the .NET backend, and how it all runs in CI.
Conventions
Commit, quality, and documentation conventions for consistent team workflows.
CLI Commands
The `ss` developer CLI and the pnpm scripts that round it out.