---

name: update-nav description: Add new pages to docs.json navigation structure. Updates navigation groups based on user journey (Customize, Deploy, etc.). Use when the user asks to add a page to navigation, update docs.json, add to nav, or include a new page in the sidebar.

Update Navigation

Add new documentation pages to the docs.json navigation structure.

Instructions

1. Identify the page: Determine which page needs to be added to navigation

   • If not specified, ask the user which file/page to add
   • Confirm the file path is correct (relative to docs root)

2. Determine navigation group: Figure out where in the navigation this belongs

   • Ask which navigation group it should go in if not specified
   • Common groups align with user journey: "Get started", "Customize", "Deploy", "Settings", etc.
   • Read docs.json to see current navigation structure and group names

3. Read current docs.json:

   • Understand the existing navigation structure
   • Find the correct group to add to
   • Note the format and patterns used

4. Update docs.json:

   • Add the new page entry to the appropriate navigation group
   • Maintain consistent formatting
   • Preserve alphabetical or logical ordering within the group if applicable
   • Ensure proper JSON syntax

5. Show changes:

   • Show the user what was added to docs.json
   • Confirm the placement is correct

Navigation structure notes

• Pages are organized by user journey, not by file structure
• Navigation group names should match existing patterns
• Each entry typically includes just the file path (e.g., "content/components/accordions")
• Only update the English language section of the docs.json navigation. Updates to all translated content, including docs.json, are handled automatically after changes are made to English language files

Example

If user says "Add the new dark-mode.mdx page to the Customize navigation":

1. Verify file exists at the specified path
2. Read docs.json to find the "Customize" group
3. Add "content/settings/dark-mode" to the appropriate location in that group
4. Show the diff for confirmation