Jumpy sidebar while navigating groups

[dtbuchholz]

To Reproduce

1. Create a starter app with the fumadocs CLI
2. Install/build
3. Add some pages so that you can create a group
4. Start in dev mode

Current vs. Expected behavior

My docs site sidebar—you can see two tab groups for CLI and SDK. If I click on an item in one of these groups, the other collapses.

demo.mp4

The official Fumadocs, for comparison. If you click on an item within different groups, nothing collapses.

demo.mp4

Provide environment information

MacOS
Node 23
pnpm 9.15.1

All fumadocs are the latest version (here's a dump from my package file)

    "@theguild/remark-mermaid": "^0.2.0",
    "fumadocs-core": "15.0.0",
    "fumadocs-docgen": "^1.3.5",
    "fumadocs-mdx": "11.3.2",
    "fumadocs-twoslash": "^3.0.0",
    "fumadocs-ui": "15.0.0",
    "katex": "^0.16.21",
    "next": "15.1.6",
    "next-themes": "^0.4.4",
    "react": "^19.0.0",
    "react-dom": "^19.0.0",
    "react-icons": "^5.4.0",
    "rehype-katex": "^7.0.1",
    "remark-math": "^6.0.0",
    "rimraf": "^6.0.1",
    "shiki": "^2.1.0",
    "tailwind-merge": "^2.6.0",
    "tailwindcss-animate": "^1.0.7"

Which area(s) are affected? (Select all that apply)

UI

Additional context

No response

[fuma-nama]

I think you're likely adding the DocsLayout component in a page.tsx, or layout.tsx under the catch-all route. Next.js unmounts them as the route params change, you need to move them to a upper place like app/docs/layout.tsx

[dtbuchholz]

Ahh wow, nice catch. Yes, I removed the docs route and made it a catch all route instead. All pages are docs such that the landing page is the same design as everything else.

But, is there any way to configure it such that the /docs slug is not included? I couldn't seem to tweak it, which is why I made the catch-all. E.g., I'll be using a docs subdomain, so there's no need for a /docs slug.

[fuma-nama]

Do you mean you want to use app/[[...slug]]/page.tsx instead of app/docs/[[...slug]]/page.tsx?

It's same like:

• app/layout.tsx - Root + Docs Layout
• app/[[...slug]]/page.tsx - Docs Page

And remember to update your loader() in lib/source.ts to include a baseUrl: "/docs" option

[dtbuchholz]

Yeah exactly. The only difference is that I want the base URL to be / so that all pages are under root in state of /docs. But it's nbd.