PixelDance
Essentials

Navigation

How to configure the docs sidebar using meta.json files.

meta.json

Every content/docs/ subdirectory can have a meta.json to control sidebar order and labels:

{
  "title": "Getting Started",
  "pages": ["index", "quickstart", "development"]
}

Pages in pages appear in that order. Unlisted pages are appended alphabetically.

Nested Sections

Create subdirectories with their own meta.json:

content/docs/
├── meta.json            ← root order
├── index.mdx
├── essentials/
│   ├── meta.json        ← section title + order
│   ├── markdown.mdx
│   └── code.mdx
└── api-reference/
    ├── meta.json
    └── index.mdx

Page Frontmatter

Every page needs at minimum a title:

---
title: My Page
description: Shown in search results and SEO metadata.
icon: BookOpen
---

Available icons are from Lucide.

Steps Component

Use <Steps> for sequential guides:

<Steps>
  <Step>First step content.</Step>
  <Step>Second step content.</Step>
</Steps>
First step content.
Second step content.

On this page