fix(docs): drop tabMode="top" that hid article body#138
Merged
Conversation
Fumadocs UI 16.8.5 places the layout tab strip in [grid-area:main],
the same grid cell as the article, with z-10 and bg-fd-background —
covering DocsTitle and the MDX body. Default tabMode ("auto") puts
the section list in the sidebar header dropdown instead, matching
the original "promote top sections to sidebar tabs" intent.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Commit
1b2bb18addedtabMode="top"todocs/src/app/docs/layout.tsx. In Fumadocs UI 16.8.5 this renders the auto-generated tab strip into[grid-area:main]— the same CSS grid cell as the article — withz-10and an opaquebg-fd-background. The strip stretches across the full main cell and completely covers<DocsTitle>plus the MDX body. The sidebar tree and right-side TOC still render, which is exactly what the bug report shows: a fully-blank center column on every docs page.This was reproducible both locally (
pnpm dev) and ondocs.byteveda.org/taskito/.... Confirmed viagrep '\[grid-area:main\]' out/docs/getting-started/installation.htmlreturning 2 elements before, 1 after.The fix drops the prop so Fumadocs falls back to the default
tabMode="auto", which renders the same auto-generated section list as aSidebarTabsDropdowninside the sidebar header — which is exactly what1b2bb18's message described ("promote top sections to sidebar tabs").docs/src/app/docs/layout.tsx.root: trueflags on the section meta.json files are still consumed bytabMode="auto", so the section dropdown is populated unchanged.Test plan
cd docs && pnpm types:check— cleancd docs && pnpm lint— cleancd docs && pnpm build— succeededgetting-started/installation,architecture/overview,guides/core/tasks,architecture,api-referenceeach contains exactly one[grid-area:main]element (the<article id="nd-page">)docs.byteveda.org/taskito/docs/getting-started/installationthat the article renders with title, description, and content visible