mint dev: empty navbar/sidebar when selected version differs from the first version block containing the current page #6574
seb86
started this conversation in
Bugs & Feedback
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
Environment
~/.mintlifyappears to be what regressed, not the CLI package; cache cleared and re-downloaded 2026-07-15)Summary
When
docs.jsonusesnavigation.versionsand the same page path is listed in more than one version's navigation,mint devrenders that page with an empty navbar (no tabs) and an empty sidebar whenever the active version is not the first version block in the array that contains the page. Page content, search, banner, and the "On this page" TOC all render normally — only navigation disappears.Minimal reproduction (4 files)
docs.json:{ "$schema": "https://mintlify.com/docs.json", "theme": "mint", "name": "Version Repro", "colors": { "primary": "#6a42d7" }, "navigation": { "versions": [ { "version": "v1", "default": true, "groups": [{ "group": "Guides", "pages": ["shared", "v1-only"] }] }, { "version": "v2", "groups": [{ "group": "Guides", "pages": ["shared", "v2-only"] }] } ] } }Plus three trivial MDX pages:
shared.mdx,v1-only.mdx,v2-only.mdx(frontmatter title/description only).Steps
mint dev/shared— renders correctly with full sidebar (v1 is first/default)./shared.Expected: sidebar shows v2's navigation (
shared,v2-only).Actual: the tab row disappears and the sidebar is empty except the version switcher. Navigating to
/v2-onlydirectly renders fine, and switching versions from there works — the failure occurs only on pages listed in multiple version blocks.Additional observations
/sharedbreaks on v1 instead.All reactions