nuxt / nuxt/ui

<UHeader> causing Hydration error when using with e.g. <LazyAccordion>

Open
#5,801 5 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

upstream/reka-ui
Dominant language
TypeScript
Stars
6.9k
Forks
1.1k
Avg merge
1d 7h
Merged PRs (30d)
57

Description

Environment
Operating system macOS 24.6.0
CPU Apple M1 Pro (10 cores)
Node.js version v22.15.0
nuxt/cli version 3.31.3
Package manager pnpm@10.27.0
Nuxt version 4.2.2
Nitro version 2.12.9
Builder vite@7.3.0
Config compatibilityDate, css, debug, devtools, modules, vite
Modules @nuxt/ui@4.3.0
Is this bug related to Nuxt or Vue?

Nuxt

Package

v4.x

Version

v4.3.0

Reproduction

https://github.com/Mat4m0/hydration

Description

When using the Header with a e.g. Lazy Loaded Accordion, we get a hydration error in production!

HEADER Image
Additional context

No response

Logs

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by running the reproduction at https://github.com/Mat4m0/hydration with Nuxt 4.2.2 and @nuxt/ui 4.3.0, then inspect the interaction between UHeader and LazyAccordion during production hydration. Done means the provided example no longer reports a hydration error in production.

Written by the indexing model from the issue text.

Assessment

Tech stack
nuxt, typescript
Domain
frontend
Issue type
Bug
Difficulty
3/5
Estimated time
1-2 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.