Posts tagged "Astro"

Astro 6 is out today, and it just works on Netlify on day one. To upgrade, run:

npx @astrojs/upgrade

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.

Watch out for import.meta.env

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:

You can now use AI Gateway in local development with just npm run dev when using the Netlify Vite Plugin. Previously, AI Gateway’s auto-configured environment variables only worked when running netlify dev, which added friction for developers using Vite-powered frameworks like Astro.

With this update, AI Gateway environment variables are automatically populated when running your Vite development server directly. This means you can run standard framework commands without extra steps:

# Works with any Vite-based framework
npm run dev

This is part of our ongoing effort to streamline the developer experience for Vite frameworks. Modern frameworks like Astro let you specify Netlify as your deployment target and handle everything automatically—now AI Gateway works the same way.

This change also improves compatibility with AI coding agents and other automated workflows that expect standard development commands to work without additional configuration.

Learn more about the Netlify Vite Plugin and AI Gateway in the documentation.