jamdesklisted

## Reference Files Read these **only when your task requires them** — the quick reference below covers most needs: | File | When to read | |------|-------------| | `reference/components.md` | Adding or modifying MDX components (Cards, Steps, Tabs, Callouts, etc.) — full props and examples | | `reference/configuration.md` | Changing docs.json settings (theme, colors, navbar, footer, integrations) — complete schema | | `reference/navigation.md` | Modifying site navigation (tabs, groups, products, versions, languages) — 8 patterns | ## Before You Start 1. Read the project's `docs.json` to understand current configuration 2. Search existing pages before creating new ones — avoid duplicates 3. Read 2-3 similar pages to match the project's voice and conventions 4. Run `jamdesk validate` before deploying to catch config errors ## Project Structure ``` my-docs/ ├── docs.json # Configuration (required) ├── introduction.mdx # Pages (at least one required) ├── guides/ │ ├── quickstart.mdx │ └── advanced.mdx ├── api/ │ ├── overview.mdx │ └── openapi.yaml # OpenAPI spec (optional) ├── images/ │ ├── logo.webp │ └── favicon.png └── snippets/ # Reusable MDX fragments └── install-tabs.mdx ``` ## Page Frontmatter ```yaml --- title: Page Title # Required — used as H1 and browser tab title description: SEO summary # Recommended — meta description for search engines sidebarTitle: Short Name # Optional — override the sid