Nuxt 4.6: wat je er nu aan hebt
Nuxt 4.6 is een grote release: meer dan 420 commits sinds 4.5.2. Voor een site op Nuxt 4 breekt er weinig. Eén ding check je wel vooraf: de versie van Node.
Kort gezegd
- 01 Check eerst Node: ^22.22.3, ^24.15.0 of 26+
- 02 Upgraden met npx nuxt upgrade --dedupe
- 03 Een nieuwe CLI die zegt waarom hij herstart
- 04 Vapor en vite-server: alleen in een testproject
Check eerst je Node-versie
Nuxt 4.6 vraagt Node ^22.22.3, ^24.15.0 of 26 en hoger. Draait je server of je build op een oudere Node 24, zet die dan eerst omhoog. Doe dat overal tegelijk: op je eigen machine, in de build en op de server. Een build op een andere Node dan de server geeft fouten die je alleen live ziet.
node -v
npx nuxt upgrade --dedupeMet --dedupe ruimt de upgrade dubbele versies van pakketten in je lockfile op. Dat voorkomt rare typefouten achteraf.
Een nieuwe CLI
Nuxt 4.6 komt met CLI v4. Die installeer je niet apart, hij komt mee met Nuxt. nuxt dev heeft nu onderin een paneel met de URL’s, de voortgang van het opstarten en sneltoetsen. Wil je de oude uitvoer terug, start dan met --no-tui.
Nuttiger dan het paneel: de dev-server zegt nu waarom hij herstart, welke config veranderde en hoe lang elke module nodig had om op te starten. Start je dev-server traag, dan zie je meteen welke module de tijd kost. Een bestand opslaan zonder wijziging herstart de server niet meer.
De CLI is ook veel kleiner: 3,5 MB in plaats van 13,1 MB, met 31 in plaats van 70 dependencies. nuxt init is weg. Een nieuw project start je met npm create nuxt@latest.
Fouten in development
De foutpagina in development is nieuw. Je ziet een stack trace die naar je eigen code wijst, met de regels eromheen. Een fout bij het opstarten, zoals een typfout in nuxt.config.ts, geeft een pagina die vanzelf herlaadt zodra je de fout oplost. Dezelfde melding staat in je terminal.
Kleine dingen die je merkt
Een link naar een bestand in
public/heeft geenexternalmeer nodig.Heeft een bestand in
public/dezelfde naam als een route, dan krijg je een waarschuwing.prerendermag bovenaan in je config, in plaats van ondernitro.prerender.Mappen als
(groep)/tellen niet meer mee in de naam van een component.
Wat je nog laat liggen
Twee onderdelen zijn experimenteel: Vue Vapor en @nuxt/vite-server, een server zonder Nitro. Probeer ze in een los testproject. Bouw er geen klantsite op, want de API gaat nog veranderen.
Nieuw en wel bruikbaar zijn de import nuxt/server en sessies in een cookie. Daar schrijf ik apart over. Voor deze upgrade hoef je er niets mee: je bestaande servercode blijft werken.
Nog op Nuxt 3?
Dan krijg je deze release niet. Nuxt 3 krijgt sinds 31 juli 2026 geen updates meer. Begin bij Van Nuxt 3 naar Nuxt 4.
Loopt je Nuxt-project vast?
Met een Nuxt-review loop ik je project door op code, performance en onderhoud. Vaste prijs: € 1.250.