System Architecture
How the codebase is built — infrastructure, routing, caching, and code organization.
The macro-level technical choices behind the platform. Start here to understand how requests flow, where data lives, and how the monorepo is split.
Infrastructure
How and where the apps run. Fly.io socket auto-stop covers the WebSocket server's machine-suspension workaround.
Routing & Locales
How URLs resolve and how next-intl gets its locale. Locale resolution in parallel routes is the deep dive on the rootParams integration.
Data & Performance
How data is cached and seeded. Caching strategy explains the "use cache" model and the locale multiplier. Seeding strategy covers the two-tier reference + demo seed split.
Global UI
Shared chrome that wraps every page. Header architecture documents the parallel-route slot composition.
Code Organization
How the monorepo is split. Commerce package and Enforcement layers describe the boundary between business truth and product experience.