nextjs - 💡(How to fix) Fix View Transition Error in Cache Component Mode [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
vercel/next.js#85693Fetched 2026-04-08 02:14:20
View on GitHub
Comments
0
Participants
1
Timeline
5
Reactions
0
Author
Participants
Timeline (top)
labeled ×2cross-referenced ×1issue_type_added ×1subscribed ×1

Error Message

When I use the experimental viewTransition in cacheComponents mode, I get a error.

Code Example

Relevant Packages:
  next: 16.0.1
  react: 19.2.0
  react-dom: 19.2.0
Next.js config:
  cacheComponents: A
  viewTransition(experimental): A
RAW_BUFFERClick to expand / collapse

Link to the code that reproduces this issue

https://github.com/HM-Suiji/nextjs-bug-report-viewtransition-with-cachecomponents

To Reproduce

When I use the experimental viewTransition in cacheComponents mode, I get a error. View transition lost the smooth transition, and in its place came a strange animation.

Current vs. Expected behavior

When the cacheComponents mode is not activated, viewTransition can transition smoothly, moving the content inside to the target position smoothly. However, once activated, this smooth movement disappears, the animation blurs for a moment and ends abruptly.

Provide environment information

Relevant Packages:
  next: 16.0.1
  react: 19.2.0
  react-dom: 19.2.0
Next.js config:
  cacheComponents: A
  viewTransition(experimental): A

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

cacheComponents, Use Cache, React

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

next dev (local), next build (local), next start (local), Vercel (Deployed), Other (Deployed)

Additional context

No response

extent analysis

TL;DR

  • Disabling cacheComponents mode may restore the smooth view transition behavior.

Guidance

  • Verify the issue by toggling cacheComponents mode and observing the transition behavior.
  • Check the Next.js documentation for any known issues or limitations with the experimental viewTransition feature in combination with cacheComponents.
  • Test the application with different caching configurations to isolate the cause of the strange animation.
  • Consider reporting the issue to the Next.js community or opening a bug report if the problem persists.

Example

  • No code snippet is provided as the issue is more related to configuration and experimental feature interaction.

Notes

  • The issue seems to be related to the experimental nature of viewTransition and its compatibility with cacheComponents.
  • The provided environment information suggests that the issue might be specific to the combination of Next.js, React, and React DOM versions used.

Recommendation

  • Apply workaround: Disable cacheComponents mode until the issue is resolved or a compatible version of Next.js is released, as this seems to restore the expected smooth transition behavior.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING