Core infrastructure covers the foundational systems that every other part of the theme depends on: the project structure, the validation pipeline that enforces quality gates, and the deployment process. Understanding these systems first makes everything else easier to navigate.
Who this is for
- Implementors — understanding the validation and deployment workflow so you can ship sites confidently.
- Developers — knowing where files live, how validation enforces correctness, and how builds produce output.
- AI agents — learning the directory layout and validation rules so generated code passes all quality gates on the first attempt.
Key concepts
- Validation pipeline — a single command runs format checking, linting, type checking, accessibility audits, and a production build in sequence. Code that fails any stage does not ship.
- Directory structure — the project follows a predictable layout separating core framework code (
src/core/) from site-specific customization (src/site/) and content (src/content/). - Deployment — the current supported deployment path is a hybrid Node.js deployment: static assets are built ahead of time, while the standalone Node server handles SSR requirement pages and API-backed routes.