Merged
Conversation
…de next to 15.4.11 from 15.5.9. Additionally upgrade baseline-browser-mapping to 2.10.0
tadjh
reviewed
Mar 11, 2026
tadjh
reviewed
Mar 11, 2026
tadjh
reviewed
Mar 11, 2026
tadjh
requested changes
Mar 11, 2026
tadjh
previously approved these changes
Mar 12, 2026
tadjh
approved these changes
Mar 18, 2026
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.
Context
BREAKING CHANGES:
The only listed breaking changes are in payload 3.79.0. Two of them.
Anaylsis of codebase vs breaking changes
Project does not currently define any custom dashboard widgets in payload.config.ts, we are using the default payload dashboard.
codebase already correctly imports Lexical types via @payloadcms/richtext-lexical/lexical (which is the recommended pattern)
CodeEditor, we are not importing or using the CodeEditor component
Changes Made
Downgraded
next: 15.5.9 → 15.4.11Upgraded
lucide-react: 0.378.0 → ^0.471.0 (latest)Upgraded
baseline-browser-mapping(latest)Remove
lexicaldependencyFurther analysis after upgrade using gemini
1. Payload CMS Compatibility Gap
Payload CMS 3.x relies on internal Next.js routing behaviors that were altered in version 15.5. Staying on
15.5.9introduced:Build Failures: Next.js 15.5's new strict TypeScript route validation rejects Payload's auto-generated API route types (specifically the
RouteHandlerConfig).Admin UI Slowness: Documented performance regressions in 15.5 cause the Payload Admin panel to experience massive load-time spikes (reported jumps from 2s to 30s+).
OLD dev tested by espdesign
✓ Compiled /admin/[[...segments]] in 5.5s (6831 modules)NEW dev tested by espdesign
` ✓ Compiled /admin/[[...segments]] in 9s (7912 modules
HMR Instability: Turbopack HMR in 15.5 frequently fails to find client modules in the manifest, leading to frequent "Module not found" errors during development.
Result: Reverting to 15.4.11 restores the "Stable Zone" for Payload 3.x, ensuring fast Admin UI performance and successful production builds.
2. React 19 Peer Conflict
The previous version of
lucide-reactwas hard-coded to expect React 18 or older.lucide-reactadds official support for React 19, resolving the peer dependency warning.Further changes:
Migrations:
No :)
Test Plan
Confirm on staging.
Confirm on dev.