Small surface. Deep documentation.

From installation to deployment, read not just how each decision is used but why it exists.

Getting started

01 Getting started Installation, your first route, your first island, the directory layout and the CLI. Read chapter 02 Architecture The decisions, their reasoning, and the middleware order that is treated as a contract. Read chapter

Building pages

03 Routing Route modules, the controller contract and how load order is decided. Read chapter 04 Rendering and templates .jsk templates, layout, components, helpers and the metadata schema. Read chapter 05 Islands The island contract, hydration strategies, shared state and DOM helpers. Read chapter

Performance

06 Caching TTLs, early refresh, host vary, stale-while-revalidate and prewarm modes. Read chapter 07 Build The pipeline, page stylesheets, Tailwind sources, and icons from a local folder or Phosphor. Read chapter

Reference

08 Configuration The complete configuration reference, field by field — including shared cookies and handoff. Read chapter 09 Dev tools The overlay with Errors and SEO tabs, the report page and the dev gate. Read chapter 10 Deployment Production, Docker, reverse proxies and health checks. Read chapter 11 Migration Moving from Next.js: the mapping table and a staged plan. Read chapter 12 dashboards Read chapter

run the examples

npm install
npm run dev

Four examples in the repository

Minimal is the smallest thing that runs, blog touches every public surface, this marketing site is the bilingual long-TTL profile, and dashboard is the private: true axis — sessions, CSRF and fragments.

With the server running, the smoke script verifies that every endpoint answers as expected.