fix(docs): align Fumadocs peer dependencies by skevetter · Pull Request #1727 · devsy-org/devsy

skevetter · 2026-10-26T18:35:55Z

Summary

Fix the Fumadocs peer dependency mismatch that caused the Netlify docs build to fail during dependency installation.

The failed docs deployment (6adf6c182569d945284011d8) reported npm ERR! ERESOLVE unable to resolve dependency tree: it resolved fumadocs-core@16.15.18, while fumadocs-mdx@15.4.9 requires peer fumadocs-core@^16.17.0. The existing fumadocs-ui alias to @fumadocs/base-ui@16.15.18 also has an exact peer on core 16.15.18.

Change

Pin fumadocs-core and the existing fumadocs-ui alias to the minimum coherent published pair, 16.17.0.
Keep fumadocs-mdx@15.4.9; do not downgrade the patch.
Regenerate the docs lockfile with npm. This corrects its root fumadocs-mdx drift from 15.4.6 to 15.4.9 and resolves dependency changes required by the updated Fumadocs package ranges.

Validation

Registry metadata confirms fumadocs-mdx@15.4.9 requires core ^16.17.0, and @fumadocs/base-ui@16.17.0 requires core exactly 16.17.0. Next 16.3.8 and React 19.2.8 satisfy the published peers.
mise exec -- npm install --package-lock-only --ignore-scripts --no-audit --no-fund --strict-peer-deps passed.
NODE_OPTIONS=--max-old-space-size=4096 mise exec -- npm ci --strict-peer-deps --no-audit --no-fund passed under Node 24.21.0 / npm 11.19.0 (257 packages). npm warned that esbuild@0.28.2 and fsevents@2.3.3 install scripts are not covered by allowScripts; no override was added. The installed esbuild executable ran and reported 0.28.2.
NODE_OPTIONS=--max-old-space-size=4096 mise exec -- npm run build passed: TypeScript passed and 112/112 static pages were generated using 11 workers. Existing warnings: Next inferred the repo root from the root and docs lockfiles, no build cache was present, and CSS parsing warned on two Fumadocs ::highlight(fd-search) selectors.
Static HTTP smoke passed for / and /docs/managing-providers/manage-providers; both returned 200 with expected titles and the provider page heading. Referenced CSS and JS assets returned 200.
Parent's Chrome check passed homepage light/dark theme, provider docs content, search, and navigation to Provider Options. Evidence: /tmp/devsy-docs-fumadocs-browser-evidence.json.
Scoped prek on the two changed JSON files passed. Pre/post SHA-256 values were unchanged: package.json ef266aecbc93b43fcef1d9c9ee63a5341abe00bb20ce8f151f7497c54b18fd0a; package-lock.json 2a663fa6980507e0630e8408ba63a0ab6e5a6413dc4fdf483b853c9f6646b5cc.
NODE_OPTIONS=--max-old-space-size=4096 mise exec -- npm run check-links passed: 0 errored file, 0 errors.

Summary by CodeRabbit

Chores
- Updated the documentation site’s underlying platform components.

netlify · 2026-10-26T18:36:02Z

✅ Deploy Preview for devsydev ready!

Name	Link
🔨 Latest commit	`dc81f4f`
🔍 Latest deploy log	https://app.netlify.com/projects/devsydev/deploys/6adf9d8f8bc6528b4a03c301
😎 Deploy Preview	https://deploy-preview-1727--devsydev.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

coderabbitai · 2026-10-26T18:36:09Z

No actionable comments were generated in the recent review.

Recent review info

Run configuration

Source mode: Auto
Repository: Unavailable
Branch: Unavailable
File: No configuration file from this repository applied
Commit: Unavailable
Layers: Organization UI
Review profile: CHILL
Plan: Advanced
Run ID: 8499ed8a-d64b-4700-bb00-8817219e4944

Commits

Reviewing files that changed from the base of the PR and between c9a7e55 and dc81f4f.

Files ignored due to path filters: 1

sites/docs-devsy-sh/package-lock.json is excluded by !**/package-lock.json

Files selected for processing: 1

sites/docs-devsy-sh/package.json

Included review availability: This review used your included allowance. Your plan provides up to 2 included reviews per hour; 0 remain after this review.

Walkthrough

The docs-devsy-sh package updates fumadocs-core and fumadocs-ui from version 16.15.18 to 16.17.0. fumadocs-mdx remains at version 15.4.9.

Changes: Fumadocs package updates

Layer / File(s)	Summary
Update Fumadocs dependency versions `sites/docs-devsy-sh/package.json`	`fumadocs-core` and `fumadocs-ui` are updated from `16.15.18` to `16.17.0`. `fumadocs-mdx` remains at `15.4.9`.

Priority: Normal

Estimated code review effort: 1 (Trivial) | ~5 minutes

Change: Bug fix

Merge Risk: Minimal · up to dc81f

The dependency updates address the reported peer-version conflict. No merge-blocking issue is established by the supplied evidence; merge after normal checks pass.

Pre-merge checks: 5

Check name	Status	Explanation
Title check		The title clearly identifies the Fumadocs peer dependency alignment and matches the main change.
Description check		The description clearly explains the problem, the dependency changes, and extensive validation. It omits several template sections, but the core required information is present.
Docstring Coverage		No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check		Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check		Check skipped because no linked issues were found for this pull request.

Full details: Docstring Coverage

Explanation

No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0 files. (1 skipped: 1 unsupported.)

Finishing Touches

✨ Simplify code

Commit to this branch
Create a new PR

Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

netlify · 2026-10-26T18:36:40Z

✅ Deploy Preview for images-devsy-sh canceled.

Name	Link
🔨 Latest commit	`dc81f4f`
🔍 Latest deploy log	https://app.netlify.com/projects/images-devsy-sh/deploys/6adf9d8f8ebe5f784788bd98

skevetter · 2026-10-26T19:06:21Z

@greptileai review

greptile-apps · 2026-10-26T19:08:48Z

Confidence Score: 5/5

[Low impact] The dependency alignment appears safe to merge.

Summary

Aligns the docs dependencies to fix the Fumadocs peer mismatch.

The docs site installs Fumadocs packages at compatible versions.

_{Reviews (1) · Last reviewed commit: "fix(docs): align Fumadocs peer dependenc..." · Reviewed by Greptile}

skevetter · 2026-10-26T19:18:45Z

@coderabbitai full review

coderabbitai · 2026-10-26T19:18:53Z

✅ Action performed

Full review finished.

mergify · 2026-10-26T19:29:05Z

This pull request does not currently match the merge queue conditions, so it cannot be queued from here. The box comes back if it matches again.

fix(docs): align Fumadocs peer dependencies

dc81f4f

github-actions Bot added the size/xs label Oct 26, 2026

skevetter marked this pull request as ready for review October 26, 2026 19:28

skevetter merged commit f5a21e3 into main Oct 26, 2026
36 checks passed

skevetter deleted the fix/docs-fumadocs-peer branch October 26, 2026 19:33

skevetter mentioned this pull request Oct 26, 2026

fix(tunnel): preserve literal host agent paths #1725

Merged

3 tasks done

Navigation Menu

Repository navigation

fix(docs): align Fumadocs peer dependencies - #1727

fix(docs): align Fumadocs peer dependencies#1727
skevetter merged 1 commit into
mainfrom
fix/docs-fumadocs-peer

skevetter commented Oct 26, 2026 •

edited by coderabbitai Bot

Loading

Uh oh!

netlify Bot commented Oct 26, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot commented Oct 26, 2026 •

edited

Loading

Uh oh!

netlify Bot commented Oct 26, 2026 •

edited

Loading

Uh oh!

skevetter commented Oct 26, 2026

Uh oh!

greptile-apps Bot commented Oct 26, 2026 •

edited

Loading

Uh oh!

skevetter commented Oct 26, 2026

Uh oh!

coderabbitai Bot commented Oct 26, 2026 •

edited

Loading

Uh oh!

mergify Bot commented Oct 26, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

skevetter commented Oct 26, 2026 • edited by coderabbitai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Change

Validation

Summary by CodeRabbit

Uh oh!

netlify Bot commented Oct 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for devsydev ready!

Uh oh!

coderabbitai Bot commented Oct 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

netlify Bot commented Oct 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

✅ Deploy Preview for images-devsy-sh canceled.

Uh oh!

skevetter commented Oct 26, 2026

Uh oh!

greptile-apps Bot commented Oct 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Confidence Score: 5/5

Summary

Uh oh!

skevetter commented Oct 26, 2026

Uh oh!

coderabbitai Bot commented Oct 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

mergify Bot commented Oct 26, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

skevetter commented Oct 26, 2026 •

edited by coderabbitai Bot

Loading

netlify Bot commented Oct 26, 2026 •

edited

Loading

coderabbitai Bot commented Oct 26, 2026 •

edited

Loading

netlify Bot commented Oct 26, 2026 •

edited

Loading

greptile-apps Bot commented Oct 26, 2026 •

edited

Loading

coderabbitai Bot commented Oct 26, 2026 •

edited

Loading

mergify Bot commented Oct 26, 2026 •

edited

Loading