Astro 6 is out today, and it just works on Netlify on day one. To upgrade, run:
This will update Astro, the Netlify adapter, and all other official integrations together.
What’s new
Some highlights include:
- Vite 7 and a redesigned dev server — Faster builds and a better dev server built from the ground up.
- Content Layer API — Legacy content collections are fully removed. All collections must now use the Content Layer API.
- Node 22 — Node 18 and 20 are no longer supported.
Check the full upgrade guide for all the details.
One change worth calling out: import.meta.env values are now always inlined at build time in Astro 6. This means if you were relying on import.meta.env to read environment variables at runtime in your server-side code, those values will be baked into your build output instead.
To read environment variables at runtime, use process.env instead:
- const apiKey = import.meta.env.API_KEY;
+ const apiKey = process.env.API_KEY;
This is especially important for secrets. If a secret is inlined into your server bundle, it’s no longer secret. The good news: Netlify’s smart secret scanning will automatically detect exposed secrets in your build output and fail the build before it goes live, so you’ll know right away if something slipped through.
Deploy an Astro 6 site on Netlify
If you want to get started with a new site, start with the Astro on Netlify doc, or just click this button:
