Guide

Usage

Author content, define sections and customise branding.

Usage

Everything product-specific stays in your app; the layer handles the rest.

Define sections

Sections are declared once in app/constants/sections.ts. Each entry maps a URL slug to a content folder:

app/constants/sections.ts
export const DOCS_SECTIONS = [
  {
    key: "guide",
    slug: "guide",
    label: "Guide",
    icon: "i-lucide-book-open",
    folder: "01.guide",
  },
] as const;

Author content

Drop markdown files under content/docs/<folder>/. Numeric prefixes control ordering and are stripped from the URL:

content/
  index.md
  docs/
    01.guide/
      01.introduction.md
      02.installation.md
      03.usage.md

Customise branding

Branding lives in app/app.config.ts (title, links, footer) and app/assets/css/main.css (colour palette). The layer never needs editing to rebrand — that is the whole point of the boundary.