# Contributor handoff — nuxt/nuxt

> Canonical page: https://codevetter.com/unpack/nuxt/agent-handoff

# Contributor handoff — nuxt/nuxt

Scanned commit 3fde4d625cc353e83ac10f6b75db8ca480167be4 (2026-10-01). Generated by codevetter codevetter 1.15.0 on 2026-10-02.

Source inspection; upstream code and tests were not executed.

Begin with repository contribution policy, the relevant package manifest, and the build/runtime boundary that owns the requested behavior. Tests and CI were inspected, not executed, so this brief supplies test targets rather than validation results. Preserve generated-module contracts, request-scoped state, cookie headers, and builder compatibility when making later authorized changes. The inventory is bounded; investigate neighboring consumers and tests before drawing absence or vulnerability conclusions.
- Read AGENTS.md and CONTRIBUTING.md before authoring artifacts: AGENTS prohibits AI-authored public writing and autonomous submitted contributions and requires disclosure of agent authorship and human-review status. — [AGENTS.md#L3-11](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/AGENTS.md#L3-L11) [CONTRIBUTING.md#L47-54](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/CONTRIBUTING.md#L47-L54)
- CONTRIBUTING contains an automated-agent fast-track note that conflicts with AGENTS; agent-scan automation can label and close automated PRs. Treat the note as a policy conflict to resolve, not authorization to submit. — [CONTRIBUTING.md#L56-57](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/CONTRIBUTING.md#L56-L57) [AGENTS.md#L7-9](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/AGENTS.md#L7-L9) [.github/workflows/agent-scan.yml#L97-105](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/.github/workflows/agent-scan.yml#L97-L105)
- Use the pinned pnpm@12.6.0 workspace and its catalogs/overrides; Vite, Rolldown, OXC, and Vue are explicitly pinned together, and Renovate explains the risk of loading a second Rolldown native binding. — [package.json#L122-125](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/package.json#L122-L125) [pnpm-workspace.yaml#L25-34](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/pnpm-workspace.yaml#L25-L34) [renovate.json#L72-72](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/renovate.json#L72-L72)
- For initialization or build changes, read core/nuxt.ts, core/builder.ts, core/app.ts, schema builder resolvers, and the chosen server integration; app-builder bundle and server-builder setup are separate lifecycle responsibilities. — [packages/nuxt/src/core/nuxt.ts#L944-963](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/packages/nuxt/src/core/nuxt.ts#L944-L963) [packages/nuxt/src/core/builder.ts#L17-36](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/packages/nuxt/src/core/builder.ts#L17-L36) [packages/nuxt/src/core/server.ts#L8-14](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/packages/nuxt/src/core/server.ts#L8-L14) [packages/schema/src/config/nitro.ts#L12-23](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/packages/schema/src/config/nitro.ts#L12-L23)
- Change template generators and discovery logic at their owners: app generation populates nuxt.vfs/#build and writes only templates marked write, while routes.mjs and imports.mjs are generated outputs. — [packages/nuxt/src/core/app.ts#L89-125](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/packages/nuxt/src/core/app.ts#L89-L125) [packages/nuxt/src/pages/module.ts#L813-828](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/packages/nuxt/src/pages/module.ts#L813-L828) [packages/nuxt/src/imports/module.ts#L121-127](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/packages/nuxt/src/imports/module.ts#L121-L127)
- Preserve TypeScript strictness and generated context separation: root options enable strict/noUncheckedIndexedAccess/noUncheckedSideEffectImports, and addTypeTemplate distinguishes Nuxt, node, and shared references. — [tsconfig.json#L14-22](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/tsconfig.json#L14-L22) [packages/kit/src/template.ts#L73-108](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/packages/kit/src/template.ts#L73-L108)
- After separately authorized runtime changes, the existing focused targets are test:runtime and test:unit; renderer legacy-error changes also require selecting renderer-legacy-errors explicitly because test:unit does not include it. — [package.json#L33-40](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/package.json#L33-L40) [vitest.config.ts#L181-184](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/vitest.config.ts#L181-L184)
- Browser verification should select the matching Playwright matrix project and inspect its exclusions first; fixture mutation suites intentionally avoid the Nitro-Vite shared project, and dev/build/Vite/Rspack applicability differs. — [playwright.config.ts#L9-50](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/playwright.config.ts#L9-L50) [package.json#L40-44](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/package.json#L40-L44)
- Tests and CI were inspected rather than executed in this investigation; their configured commands and source assertions are future verification pointers, not proof that this checkout passes. — [package.json#L28-48](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/package.json#L28-L48) [.github/workflows/ci.yml#L275-298](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/.github/workflows/ci.yml#L275-L298) [.github/workflows/ci.yml#L506-510](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/.github/workflows/ci.yml#L506-L510)
- Preparation is material to test/build behavior: renderer projects generate fixture artifacts, and build ensures generated tsconfigs exist before starting a bundler because missing references can be cached as failures. — [vitest.config.ts#L148-175](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/vitest.config.ts#L148-L175) [packages/nuxt/src/core/builder.ts#L154-165](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/packages/nuxt/src/core/builder.ts#L154-L165)
- Keep application and request isolation intact: createNuxtApp owns reactive payload registries, renderer instances own options/artifact loaders, and sessionCache keys sessions by event object and cookie name. — [packages/nuxt/src/app/nuxt.ts#L247-297](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/packages/nuxt/src/app/nuxt.ts#L247-L297) [packages/nuxt/src/runtime/server/renderer/instance.ts#L5-26](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/packages/nuxt/src/runtime/server/renderer/instance.ts#L5-L26) [packages/nuxt/src/server/session.ts#L134-144](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/packages/nuxt/src/server/session.ts#L134-L144) [packages/nuxt/src/server/session.ts#L186-192](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/packages/nuxt/src/server/session.ts#L186-L192)
- Do not equate server.builder:'vite' with Nitro feature parity or treat internal server-build helpers as stable public APIs; both sources explicitly describe experimental limitations. — [packages/vite-server/src/index.ts#L17-35](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/packages/vite-server/src/index.ts#L17-L35) [packages/kit/src/internal/server-build.ts#L7-10](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/packages/kit/src/internal/server-build.ts#L7-L10)
- For performance or streaming work, account for disabled benchmark CI, the dev CSS fixme, and committed streaming status behavior; no benchmark improvement or comprehensive browser coverage was established by this source inspection. — [.github/workflows/ci.yml#L370-374](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/.github/workflows/ci.yml#L370-L374) [test/e2e/ssr-streaming.test.ts#L267-275](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/test/e2e/ssr-streaming.test.ts#L267-L275) [test/e2e/ssr-streaming.test.ts#L345-389](https://github.com/nuxt/nuxt/blob/3fde4d625cc353e83ac10f6b75db8ca480167be4/test/e2e/ssr-streaming.test.ts#L345-L389)

Every claim links to its cited files at the pinned commit. Citations identify source evidence; they do not establish runtime correctness. Independent CodeVetter scan — not reviewed by upstream maintainers.

## Public product links

- [CodeVetter](https://codevetter.com/)
- [Download](https://codevetter.com/download)
- [Documentation](https://codevetter.com/docs/)
- [Source](https://github.com/Codevetter/codevetter)