Skip to content

feat(app): upgrade to Nuxt 4.5 and forward prefetch preload hints - #281

Open
PhenX wants to merge 1 commit into
mainfrom
claude/nuxt-4-5-upgrade-plnz4x
Open

feat(app): upgrade to Nuxt 4.5 and forward prefetch preload hints#281
PhenX wants to merge 1 commit into
mainfrom
claude/nuxt-4-5-upgrade-plnz4x

Conversation

@PhenX

@PhenX PhenX commented Jul 19, 2026

Copy link
Copy Markdown
Collaborator

Bump nuxt to ^4.5.0, which pulls in Vite 8.1.5 and unhead v3.

Changes

  • nuxt ^4.2.1^4.5.0 (application/package.json).
  • experimental.prefetchPreloadTags: true — forwards a prefetched <NuxtLink> target's useHead preload hints (downgraded to rel="prefetch") into the current document, warming the next navigation's assets.
  • Root overrides pinning @unhead/vue and unhead to ^3.1.8 so the whole tree resolves to unhead v3 (Nuxt 4.5 requires it). The latest @nuxt/ui still declares an unhead v2 range but only consumes createHead, which exists in v3, so a single v3 instance is safe.

Not included

  • experimental.ssrStreaming was evaluated but left off: enabling it blanks the <title> and document on the initial dev-mode SSR render, which fails the functional Playwright suite. It can be revisited once it's compatible with the app's head setup.

Verification

  • Production SSR build ✓, demo static generate ✓, nuxt typecheck ✓, 747 unit tests ✓.

🤖 Generated with Claude Code

@github-actions

github-actions Bot commented Jul 19, 2026

Copy link
Copy Markdown
Contributor

Coverage Report for Reporter (./reporter)

Status Category Percentage Covered / Total
🔵 Lines 64.01% 1450 / 2265
🔵 Statements 62.31% 1647 / 2643
🔵 Functions 70.43% 243 / 345
🔵 Branches 58.86% 1195 / 2030
File CoverageNo changed files found.
Generated in workflow #971 for commit 7c43286 by the Vitest Coverage Report Action

@github-actions

github-actions Bot commented Jul 19, 2026

Copy link
Copy Markdown
Contributor

Coverage Report for Application (./application)

Status Category Percentage Covered / Total
🔵 Lines 31.53% 2907 / 9217
🔵 Statements 31.07% 3349 / 10777
🔵 Functions 31.03% 536 / 1727
🔵 Branches 28.02% 2410 / 8598
File CoverageNo changed files found.
Generated in workflow #971 for commit 7c43286 by the Vitest Coverage Report Action

@PhenX
PhenX force-pushed the claude/nuxt-4-5-upgrade-plnz4x branch from 76f7b19 to a6c85aa Compare July 19, 2026 08:18
@PhenX PhenX changed the title feat(app): upgrade to Nuxt 4.5 with SSR streaming and prefetch preload feat(app): upgrade to Nuxt 4.5 and forward prefetch preload hints Jul 19, 2026
Bump nuxt to ^4.5.0 (pulls in Vite 8.1.5 and unhead v3). Enable
experimental.prefetchPreloadTags so a prefetched <NuxtLink> target's
useHead preload hints are forwarded (downgraded to rel="prefetch")
into the current document, warming the next navigation's assets.

Add a root overrides entry pinning @unhead/vue and unhead to ^3.1.8 so
the whole tree resolves to unhead v3 (Nuxt 4.5 requires it); @nuxt/ui
still declares an unhead v2 range but only consumes createHead, which
exists in v3.

experimental.ssrStreaming was evaluated but left off: it blanks the
title and document on the initial dev-mode SSR render, which fails the
functional test suite. It can be revisited once compatible.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01VtJWf2tQ4QuwyvvXdRRLbB
@PhenX
PhenX force-pushed the claude/nuxt-4-5-upgrade-plnz4x branch from a6c85aa to 7c43286 Compare July 19, 2026 11:07
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.

2 participants