Sidebar configuration
Arrange documentation sections and page order with navigation metadata.
Current Docsio sites use meta.json files to arrange the documentation tree. Add one at the root of docs/ and inside sections that need a specific order.
Root navigation
{
"title": "Documentation",
"pages": ["index", "getting-started", "guides", "reference"]
}Names refer to pages or folders in the same directory. Omit the file extension. Ensure the named pages exist before linking to them.
Section navigation
Inside docs/getting-started/meta.json:
{
"title": "Getting started",
"icon": "Rocket",
"pages": ["index", "quickstart", "installation"]
}The section's index.mdx can introduce the topic and link to the important tasks.
Top-level tabs
A section can become a navigation root with "root": true in its metadata. Use this for distinct areas such as Documentation and API reference, rather than turning every small folder into a tab. Ask the agent to organize the sections and verify the result on mobile.
Existing projects
Older sites may use different category files. Keep the format already used by that project. Do not replace navigation configuration without checking its pages and public URLs.