Skip to content

chore(docs): upgrade fumadocs to latest minor versions#4462

Merged
waleedlatif1 merged 2 commits intostagingfrom
waleedlatif1/fumadocs-upgrade-check
May 6, 2026
Merged

chore(docs): upgrade fumadocs to latest minor versions#4462
waleedlatif1 merged 2 commits intostagingfrom
waleedlatif1/fumadocs-upgrade-check

Conversation

@waleedlatif1
Copy link
Copy Markdown
Collaborator

Summary

  • bump fumadocs-core/ui 16.6.7 → 16.8.5, fumadocs-mdx 14.2.8 → 14.3.2, fumadocs-openapi 10.3.13 → 10.8.1
  • migrate deprecated sidebar.tabs to top-level tabs prop on DocsLayout (per 16.7 deprecation)
  • fix pre-existing typo slots.paremetersslots.parameters surfaced by stricter openapi slot types
  • 16.8.7 was held back by minimum-release-age (2 days old); landed on 16.8.5 (week-old) instead

Type of Change

  • Chore / dependency upgrade

Testing

  • bun run lint clean
  • bun run type-check clean
  • bun run build (apps/docs) completes full SSG build (2240 doc paths, 373 llms.mdx paths)
  • Custom search route, OpenAPI generated pages, sidebar method badges, i18n locales all unaffected — verified usage against changelogs

Checklist

  • Code follows project style guidelines
  • Self-reviewed my changes
  • Tests added/updated and passing
  • No new warnings introduced
  • I confirm that I have read and agree to the terms outlined in the Contributor License Agreement (CLA)

- fumadocs-core: 16.6.7 -> 16.8.5
- fumadocs-ui: 16.6.7 -> 16.8.5
- fumadocs-mdx: 14.2.8 -> 14.3.2
- fumadocs-openapi: 10.3.13 -> 10.8.1
- migrate deprecated sidebar.tabs to top-level tabs prop
- fix pre-existing typo (slots.paremeters) surfaced by stricter openapi types
@vercel
Copy link
Copy Markdown

vercel Bot commented May 6, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview, Comment May 6, 2026 0:50am

Request Review

@cursor
Copy link
Copy Markdown

cursor Bot commented May 6, 2026

PR Summary

Medium Risk
Moderate risk due to upgrading fumadocs-* dependencies (docs rendering/build behavior can change), though app-level code changes are minimal and localized.

Overview
Updates the docs app to newer minor versions of fumadocs-core, fumadocs-ui, fumadocs-mdx, and fumadocs-openapi (with corresponding bun.lock refresh).

Fixes the OpenAPI operation layout render slot typo in page.tsx (slots.paremetersslots.parameters), ensuring the parameters section renders correctly under the updated, stricter slot typings.

Reviewed by Cursor Bugbot for commit b25acde. Configure here.

@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps Bot commented May 6, 2026

Greptile Summary

This PR upgrades the four fumadocs packages to their latest minor versions and fixes a pre-existing typo in the OpenAPI slot name that was surfaced by the stricter types introduced in the new release.

  • Dependency bumps: fumadocs-core/fumadocs-ui 16.6.7 → 16.8.5, fumadocs-mdx 14.2.8 → 14.3.2, fumadocs-openapi 10.3.13 → 10.8.1; all pinned to exact versions with the lockfile updated accordingly.
  • Typo fix: slots.paremetersslots.parameters in renderOperationLayout — the misspelling silently rendered nothing before; the corrected slot name now properly outputs the parameters section.
  • Claimed migration gap: The PR description lists migrating sidebar.tabs to the top-level tabs prop as completed, but apps/docs/app/[lang]/layout.tsx was not changed and still uses the deprecated sidebar: { tabs: false } form from fumadocs < 16.7.

Confidence Score: 5/5

Safe to merge — all changed files are scoped to the docs app, the typo fix is a clear correctness improvement, and the fumadocs bumps are minor-version upgrades verified with a full SSG build.

The changes are narrow: three files touched, all within the docs workspace, with no impact on the main application. The version bumps are minor-version increments with no breaking changes, the typo fix is a net positive, and the author reports a clean lint, type-check, and full 2240-path build.

apps/docs/app/[lang]/layout.tsx — the sidebar.tabs deprecation migration claimed in the PR description was not applied here.

Important Files Changed

Filename Overview
apps/docs/app/[lang]/[[...slug]]/page.tsx Fixes pre-existing typo slots.paremeters → slots.parameters in the renderOperationLayout callback; no logic changes beyond the stricter OpenAPI slot types surfaced by the upgrade.
apps/docs/package.json Bumps all four fumadocs packages to their latest minor versions (core/ui 16.6.7→16.8.5, mdx 14.2.8→14.3.2, openapi 10.3.13→10.8.1); all are pinned exact versions, no range changes.
bun.lock Lockfile regenerated to track the new fumadocs package versions and their transitive dependency graph; no unexpected additions.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A[fumadocs-core/ui 16.6.7] -->|bump| B[fumadocs-core/ui 16.8.5]
    C[fumadocs-mdx 14.2.8] -->|bump| D[fumadocs-mdx 14.3.2]
    E[fumadocs-openapi 10.3.13] -->|bump| F[fumadocs-openapi 10.8.1]
    F -->|stricter slot types| G[slots.paremeters typo surfaced]
    G -->|fix| H[slots.parameters ✓]
    B -->|16.7 deprecation| I[sidebar.tabs → top-level tabs prop]
    I -->|claimed done| J{layout.tsx changed?}
    J -->|No| K[sidebar.tabs still in deprecated location ⚠️]
    J -->|Yes| L[Migration complete]
Loading

Reviews (2): Last reviewed commit: "fix(docs): revert sidebar.tabs migration..." | Re-trigger Greptile

The top-level tabs prop is only on fumadocs-ui 16.7+; deploy env was
still resolving an older type and failing typecheck. sidebar.tabs is
deprecated but still functional — keep it for now.
@waleedlatif1
Copy link
Copy Markdown
Collaborator Author

@greptile

@waleedlatif1
Copy link
Copy Markdown
Collaborator Author

@cursor review

Copy link
Copy Markdown

@cursor cursor Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

Reviewed by Cursor Bugbot for commit b25acde. Configure here.

@waleedlatif1 waleedlatif1 merged commit d517415 into staging May 6, 2026
14 checks passed
@waleedlatif1 waleedlatif1 deleted the waleedlatif1/fumadocs-upgrade-check branch May 6, 2026 00:54
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant