diff --git a/errors/version-staleness.mdx b/errors/version-staleness.mdx index 4ed270d4dcd38a..2a19709c1005c3 100644 --- a/errors/version-staleness.mdx +++ b/errors/version-staleness.mdx @@ -1,63 +1,73 @@ --- -title: Version Staleness +title: A newer version is available --- -## Why This Error Occurred +## What this notice means -In the error overlay, a message was shown that the detected Next.js version was out-of-date. +The development overlay shows that your installed version of Next.js is not the latest available. During development, Next.js checks the [npm registry](https://www.npmjs.com/package/next) and compares your installed version against the latest release. If a newer version is available, Next.js displays a notice in the overlay. -To get the newest features and bug fixes, it is recommended to stay up to date. +Newer versions contain bug fixes and improved error tracing capabilities. Upgrade before investigating further. -## Possible Ways to Fix It +Upgrading Next.js won't fix errors that originate in your own code or third-party libraries. However, newer versions often provide better error messages and stack traces that can help you identify the root cause. -If you are testing out a canary release, upgrade Next.js with one of the following: +If upgrading does not resolve your issue, search [GitHub Discussions](https://github.com/vercel/next.js/discussions) to see if others have encountered the same problem. If you cannot find a match, consider creating a new discussion with details about your error. -```bash filename="Terminal" -npm i next@canary -``` +If you believe the issue is a bug in Next.js and you have a minimal, shareable reproduction repository, [open an issue on GitHub](https://github.com/vercel/next.js/issues/new/choose). -```bash filename="Terminal" -yarn add next@canary -``` +> **Good to know:** A reproduction repository is required when opening an issue. Issues without one are automatically closed. -```bash filename="Terminal" -pnpm add next@canary -``` +## Staleness levels -```bash filename="Terminal" -bun add next@canary -``` +- **Stale (patch or minor):** A newer stable release is available with bug fixes or new features. +- **Stale (prerelease):** You are on a canary release and a newer canary is available. Canary versions are published frequently, so this is expected. +- **Outdated (major):** Your installed version is behind by a major version. Upgrading is recommended to get security fixes and new features. + +## Upgrading -If you are using a stable release, upgrade Next.js with one of the following: +Latest stable version: -```bash filename="Terminal" +![npm version](https://img.shields.io/npm/v/next/latest?label=next@latest&color=black) + +To upgrade to the latest stable release: + +```bash package="npm" npm i next@latest ``` -```bash filename="Terminal" +```bash package="yarn" yarn add next@latest ``` -```bash filename="Terminal" +```bash package="pnpm" pnpm add next@latest ``` -```bash filename="Terminal" +```bash package="bun" bun add next@latest ``` -If you are coming from an older major version, check out our [upgrade guides](/docs/pages/guides/upgrading). +To upgrade to the latest canary release: + +```bash package="npm" +npm i next@canary +``` + +```bash package="yarn" +yarn add next@canary +``` + +```bash package="pnpm" +pnpm add next@canary +``` + +```bash package="bun" +bun add next@canary +``` -### Note +If you are coming from an older major version, check out the [upgrade guides](/docs/app/guides/upgrading). -If you want to report a bug on GitHub, you should upgrade to the newest canary release of Next.js first, to see if the bug has already been fixed in canary. +## Contributing -## Useful Links +Next.js is open source and welcomes contributions. If you have identified a bug and want to fix it yourself, see the [contributing guide](https://github.com/vercel/next.js/blob/canary/contributing.md) or watch [How to Contribute to Open Source (Next.js)](https://www.youtube.com/watch?v=cuoNzXFLitc) to get started. -- [Upgrade guide](/docs/pages/guides/upgrading) -- [Video: How to Contribute to Open Source (Next.js)](https://www.youtube.com/watch?v=cuoNzXFLitc) -- [Contributing to Next.js](https://github.com/vercel/next.js/blob/canary/contributing.md) -- [Triaging issues](https://github.com/vercel/next.js/blob/canary/contributing/repository/triaging.md) -- [Verifying canary](https://github.com/vercel/next.js/blob/canary/.github/comments/verify-canary.md) -- [Adding a reproduction](https://github.com/vercel/next.js/blob/canary/.github/comments/invalid-reproduction.md) -- [Simplifying a reproduction](https://github.com/vercel/next.js/blob/canary/.github/comments/simplify-reproduction.md) +You can also help by [triaging issues](https://github.com/vercel/next.js/blob/canary/contributing/repository/triaging.md), [verifying canary releases](https://github.com/vercel/next.js/blob/canary/.github/comments/verify-canary.md), or providing a [minimal reproduction](https://github.com/vercel/next.js/blob/canary/.github/comments/invalid-reproduction.md) for existing issues.