adding handbook and docs pages

both handbook and docs use the same system. pages are MDX files (markdown with React component support) that live in the content/ folder.

folder structure

content/
├── handbook/           → /handbook/*
│   ├── index.mdx       → /handbook (landing page content)
│   ├── 01-section/     → /handbook/section
│   │   ├── index.mdx   → section landing page
│   │   └── 01-page.mdx → /handbook/section/page
│   └── 02-other.mdx    → /handbook/other
└── docs/               → /docs/*
    └── (same structure)

creating a new page

  1. create an .mdx file in the appropriate folder
  2. add frontmatter with at least a title:
---
title: "your page title"
---
  1. write your content in markdown below the frontmatter

ordering pages

use numeric prefixes to control the order in the sidebar menu:

  • 01-first-page.mdx appears before 02-second-page.mdx
  • prefixes are stripped from URLs (01-setup.mdx → /docs/setup)
  • pages without prefixes appear at the end, sorted alphabetically

creating sections (nested pages)

  1. create a folder with a numeric prefix: 01-section-name/
  2. add an index.mdx inside for the section landing page
  3. add child pages with their own prefixes: 01-child.mdx, 02-child.mdx

using React components

since these are MDX files, you can use React components. custom styled components are available for:

  • code - inline code
  • pre - code blocks
  • headings, lists, paragraphs

tips

  • keep filenames lowercase with hyphens (no spaces)
  • titles come from frontmatter, not filenames
  • the sidebar auto-generates from the folder structure