added interactive nesting component - #6821
Conversation
|
Excited for feedback: CleanShot.2026-07-30.at.14.18.50.mp4 |
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
|
pushed changes making it more interactive and giving a preview of what the nav structure looks like |
![cursor[bot]](https://avatars.githubusercontent.com/in/1210556?s=60&v=4){kind=small}
There was a problem hiding this comment.
Cursor Bugbot has reviewed your changes using default effort and found 1 potential issue.
❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.
Want higher recall? High effort reviews run extra passes and find more bugs. A team admin can switch effort levels in the Cursor dashboard.
Reviewed by Cursor Bugbot for commit 0631ebe. Configure here.
| const empty = { navbarRows: [], sidebarHeaderRows: [], sidebarContent: null } | ||
| if (!division || !nodes.length) return empty | ||
| if (division === "pages") { | ||
| return { ...empty, sidebarContent: <div className="space-y-0.5">{nodes.map((entry) => renderPreviewPage(entry))}</div> } |
There was a problem hiding this comment.
Preview crashes on nested groups
High Severity
collectPreview always renders pages entries with renderPreviewPage, which assumes every entry is a leaf with a value string. + Nest a group can put group containers into that same pages array, so preview calls .trim() on undefined and throws. Because preview is computed on every render, this takes down the whole builder, not just the preview pane. The editor and JSON paths already branch on entry.type.
Additional Locations (1)
Reviewed by Cursor Bugbot for commit 0631ebe. Configure here.
3 participants
Documentation changes
Created a new interactive navigation schema builder for the nesting section of navigation page. Allows user to combines components of our navigation schema and provides json output to copy to help structure their own docs.
For Reviewers
When reviewing documentation PRs, please consider:
✅ Technical accuracy
✅ Clarity and completeness
✅ User experience
Note
Low Risk
Documentation-only change plus a client-side docs snippet; no backend, auth, or production app logic.
Overview
Replaces the long static
CodeGroupJSON examples in the Nesting section oforganize/navigation.mdxwith an interactive Navigation builder embedded viaNavigationBuilder.Readers pick a root pattern (tabs, products, versions, etc.), add and nest navigation elements with rules that mirror the doc’s “one child type per level” guidance, then copy generated
navigationJSON or use a live preview (navbar switchers, anchors/menu, sidebar groups/pages).The new
snippets/navigation-builder.jsximplements the tree editor,CHILD_OPTIONSvalidation, JSON serialization, clipboard copy, and preview interactions (tabs, dropdowns, keyboard/pointer dismiss).Reviewed by Cursor Bugbot for commit 0631ebe. Bugbot is set up for automated code reviews on this repo. Configure here.