Project Structure

Content, SSR TypeScript, and Handlebars templates are separated so each layer has one job.

Directory overview

1examples/frameworks/with-vanilla-hbs/2  content/3    guide/              Markdown for the guide collection, including `kitchen-sink.md`4    pages/              Standalone pages (about)5  public/6    favicon.svg         Copied to the site root by Vite7  templates/8    layout.hbs          HTML shell, sidebar chrome, Pagefind UI9    article.hbs         Guide + standalone markdown article body10    index.hbs           Home body (still uses layout partial)11    about.hbs           About page body12  src/13    entry-server.tsx    createContentLayer, routing, Handlebars render14    theme.css           Site styles15  client.js             Browser entry (CSS + core runtime)16  content.config.mjs    Collection definitions (Zod)17  vite.config.ts        Vite + pagesmithSsg18  llms.txt              Agent-oriented integration notes (not part of the build graph)19  package.json20  tsconfig.json

Key files

templates/layout.hbs

Shell shared by every page: head, header, sidebar, footer, Pagefind modal, theme scripts. The home branch wraps the home body in a doc-home-content container (this is where data-pagefind-body lives for the index route). Inner pages use a doc-layout grid: sidebar column, <main class="doc-main"> for {{> body}}, then aside for TOC. Article-specific data-pagefind-body is on the <article> in article.hbs / about.hbs, not on that outer <main>.

templates/article.hbs / about.hbs

Partial-block wrappers around {{{content}}}. They define the inline body partial consumed by layout.hbs.

src/entry-server.tsx

Imports content.config.mjs, constructs the content layer, sorts and groups entries, registers Handlebars helpers and the layout partial, compiles page templates, implements getRoutes / render.

content.config.mjs

Plain ESM so the SSR bundle can import collection definitions without compiling the config through a separate step.

client.js

Imports src/theme.css and @pagesmith/site/runtime/content. It does not render templates; it layers behavior on generated HTML.

vite.config.ts

pagesmithSsg entry points at src/entry-server.tsx and watches ./content for dev reloads.