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