@nuvio/next
v2.0.0
Published
Nuvio Next.js dev adapter (v2) — withNuvio, custom dev server, Brand Kit, click-to-tag.
Readme
@nuvio/next
Next.js dev adapter for Nuvio v2.0 — App Router and Pages Router, webpack dev, Brand Kit, click-to-tag.
What it does
withNuvio()— webpack jsx-loc loader + dev-only wiring innext.configcreateNuvioNextDevServer()— custom dev server with WebSocket + live source index- Shared HTTP endpoints:
/__nuvio/brand,/__nuvio/pcc(Brand Kit cross-page)
Works with @nuvio/overlay/next (NuvioNextShell) mounted in your root layout.
Quick start
pnpm dlx @nuvio/cli init --yes
pnpm devManual wiring
pnpm add -D @nuvio/next @nuvio/overlay- Add
withNuvio()tonext.config.ts - Create
server.jswithcreateNuvioNextDevServer(); point"dev"at it - Mount
NuvioNextShell+import "@nuvio/overlay/style.css"in root layout
Full guide: docs/mds/NEXT.md
Dogfood app
pnpm dev:next # from monorepo root → http://localhost:3001See apps/next-dogfood — routes /, /forms, /badges with PCC manifests.
Requirements
- Node 20+
- Next.js 14.x or 15.x
- React 18.3+ or 19.x
- Custom dev server (plain
next devwithout Nuvio attach does not connect the overlay)
Limitations
- Turbopack dev (
--turbo) may skip click-to-tag until loader support lands - Patch targets are client-rendered JSX hosts (not Server Component modules directly)
