Astro 5.8 is a Nodally fresh update which bumps the minimum required version of Node.js.

🔄 Keeping things up to date:

• Updated minimum Node.js version to 18.20.8

To upgrade an existing project, use the automated @astrojs/upgrade CLI tool. Alternatively, upgrade manually by running the upgrade command for your package manager:

# Recommended:
npx @astrojs/upgrade
# Manual:
npm install astro@latest
pnpm upgrade astro --latest
yarn upgrade astro --latest

Updated minimum Node.js version to 18.20.8

Node.js 18 has now reached end-of-life and will no longer receive security updates or support. Therefore, Astro 5.8 now requires v20.3.0, v22.0.0 or higher. (v19 and v21 are not supported.) To help users upgrade, Astro will temporarily continue to support Node.js 18.20.8, which is the final LTS release of Node.js 18.

We will drop support for Node.js 18 entirely in a future release, so we recommend upgrading to Node.js 22 as soon as possible. See Astro’s Node.js support policy for more details about how and when we upgrade the minimum Maintenance LTS version.

You can check your current Node.js version by running:

You will need to update both your local development environment and any CI/CD environments to use Node.js 18.20.8 or one of the supported versions. You can check the docs for your deployment platform to see how to set the Node.js version. This might involve choosing an option in a dashboard, setting an environment variable, or adding a configuration file to your project. Many platforms will respect the NODE_VERSION environment variable or a .nvmrc file.

For example, to set the Node.js version to 22, you can create a .nvmrc file in your project root with the following content:

See the nvm docs for more details on how to use .nvmrc files.

Bug fixes

As always, we’ve been working hard on fixing issues since the 5.7 release. See the changelog for all the details.

The Astro core team is:

Ben Holmes , Caleb Jasik , Chris Swithinbank , Emanuele Stoppa , Erika , Florian Lefebvre , Fuzzy , HiDeoo , Luiz Ferraz , Matt Kane , Matthew Phillips , Nate Moore , Reuben Tier , Sarah Rainsberger , and Yan Thomas .

Thanks to all the other contributors who helped make Astro 5.8 possible, with code and docs additions and improvements, including:

Adam Matthiesen, Alan, Alex Carpenter, Alexey Zimarev, Angelo Verlain Shema, Ariel K, Armand Philippot, Augusto César Perin, Bugo, casungo, emily-shen, Federico Tibaldo, Felix Schneider, Giles Butler, Ginger, HAL, happydev, Hiromasa Fujimori, John Memmott, Jonathan Yeong, JP Wienekus, Juan Diaz, Julia March, Junseong Park, Katsuyuki Karasawa, knj, Leo Developer, Lofty-Brambles, Louis Escher, Luiz Gonzaga dos Santos Filho, Luan Rodrigues, Marcos Corrochano Arroyo, Martin Trapp, Matt Yoho, Matthew Justice, Max Chang, Michael Stramel, Murilo Silva, Ming-jun Lu, Niall O’Brien, Nils Haberkamp, Nin3, Paul Valladares, Petr Paločko, randomguy-2650, Roman Stetsyk, Sajjad Hashemian situ2001, Soufiane, Spencer Davies, Tanishq Manuja, Thomas Bonnet, Tillmann Hübner, vrabe, WP Infusion, Zev Ross, Игорь Теплостанский, 翠, and /jb.

We look forward to seeing what you build with Astro 5.8! If you have questions, comments, or just want to say hi, drop by the Astro Discord.