diff --git a/docs/1.getting-started/12.upgrade.md b/docs/1.getting-started/12.upgrade.md index 4e07ea4c44..8ddabf279f 100644 --- a/docs/1.getting-started/12.upgrade.md +++ b/docs/1.getting-started/12.upgrade.md @@ -35,11 +35,17 @@ bunx nuxi upgrade To use the latest Nuxt build and test features before their release, read about the [nightly release channel](/docs/guide/going-further/nightly-release-channel) guide. +::alert{type="warning"} +The nightly release channel `latest` tag is currently tracking the Nuxt v4 branch, meaning that it is particularly likely to have breaking changes right now - be careful! + +You can opt in to the 3.x branch nightly releases with `"nuxt": "npm:nuxt-nightly@3x"`. +:: + ## Testing Nuxt 4 Nuxt 4 is planned to be released **on or before June 14** (though obviously this is dependent on having enough time after Nitro's major release to be properly tested in the community, so be aware that this is not an exact date). -Until then, it is possible to test many of Nuxt 4's breaking changes from Nuxt version 3.12 or via the nightly release channel. +Until then, it is possible to test many of Nuxt 4's breaking changes from Nuxt version 3.12+. ::tip{icon="i-ph-video-duotone" to="https://www.youtube.com/watch?v=r4wFKlcJK6c" target="_blank"} Watch a video from Alexander Lichter showing how to opt in to Nuxt 4's breaking changes already. @@ -47,7 +53,7 @@ Watch a video from Alexander Lichter showing how to opt in to Nuxt 4's breaking ### Opting in to Nuxt 4 -First, upgrade Nuxt to the [latest release](https://github.com/nuxt/nuxt/releases) or opt in to the nightly release channel [following these steps](/docs/guide/going-further/nightly-release-channel#opting-in). +First, upgrade Nuxt to the [latest release](https://github.com/nuxt/nuxt/releases). Then you can set your `compatibilityVersion` to match Nuxt 4 behavior: diff --git a/docs/2.guide/3.going-further/11.nightly-release-channel.md b/docs/2.guide/3.going-further/11.nightly-release-channel.md index 4f1734a7d5..f359b5bc73 100644 --- a/docs/2.guide/3.going-further/11.nightly-release-channel.md +++ b/docs/2.guide/3.going-further/11.nightly-release-channel.md @@ -15,6 +15,12 @@ The build and publishing method and quality of these 'nightly' releases are the Features that are only available on the nightly release channel are marked with an alert in the documentation. :: +::alert{type="warning"} +The `latest` nightly release channel is currently tracking the Nuxt v4 branch, meaning that it is particularly likely to have breaking changes right now - be careful! + +You can opt in to the 3.x branch nightly releases with `"nuxt": "npm:nuxt-nightly@3x"`. +:: + ## Opting In Update `nuxt` dependency inside `package.json`: