Astro 7.3

Astro 7.3 is here! This release brings the

--ignore-lock

flag to

astro preview

, so you can run more than one preview server at once. It also passes Astro’s runtime logger into custom image services and cache providers, so their warnings respect your logging setup instead of writing straight to the console. Alongside the release,

@astrojs/cloudflare

ships a

finalize()

helper for custom worker entrypoints.

Explore what’s new in this release:

• Run multiple preview servers at once
• Logger for image services and cache providers
• Cloudflare finalize() helper for custom fetch handlers
• Community

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@latestpnpm upgrade astro --latestyarn upgrade astro --latest
    

Run multiple preview servers at once

Astro 7.1 added an

--ignore-lock

flag to

astro dev

so you could run more than one dev server at once, bypassing the lockfile that keeps AI agents from spinning up duplicates. Astro 7.2 added that lockfile to

astro preview

too, but without the same escape hatch. Astro 7.3 closes that gap.

      astro preview --ignore-lock
    

There are some cases where you might want multiple dev or preview servers running. One example is when doing Playwright tests. Now you can pass

--ignore-lock

to allow them to run at once.

These instances run independently, so they’re meant for quick, one-off servers rather than ones you manage with

astro preview stop

or

status

.

Logger for image services and cache providers

Astro’s custom logger lets you route Astro’s own output to your logging setup, but custom image services and cache providers couldn’t take advantage of it. If they needed to warn about something, like an unsupported image format or a skipped cache entry, their only option was

console.warn()

, which ignores your configured log level, destination, or the

--silent

flag entirely.

Astro 7.3 passes a

logger

into both extension points. Image services receive it as an argument to their hooks:

      import type { LocalImageService } from 'astro';
const service: LocalImageService = {  // ...  async transform(inputBuffer, transform, imageConfig, logger) {    logger.warn(`Could not optimize "${transform.src}". Passing it through unchanged.`);    return { data: inputBuffer, format: 'png' };  },};
    

Cache providers receive it on the context passed to

onRequest()

:

      import type { CacheProvider } from 'astro';
const provider: CacheProvider = {  name: 'my-cache',  async onRequest({ request, url, logger }, next) {    logger.warn(`Skipping cache for ${url.pathname} because the response sets a cookie.`);    return next();  },  // ...};
    

Astro’s own built-in Sharp image service and

memoryCache()

provider have been updated to use this too, so their warnings behave the same as the rest of Astro’s output.

Cloudflare finalize() helper for custom fetch handlers

If you have a custom worker entrypoint on Cloudflare,

@astrojs/cloudflare

now ships a

finalize()

helper that applies cookies and Cloudflare’s CDN cache defaults to the response coming out of an

astro/fetch

pipeline:

      import { astro, FetchState } from 'astro/fetch';import { cf, finalize } from '@astrojs/cloudflare/fetch';
export default {  async fetch(request: Request, env: Env, context: ExecutionContext) {    const state = new FetchState(request);    const asset = await cf(state, env, context);    if (asset) return asset;
    return finalize(state, await astro(state));  },};
    

With Hono, the

@astrojs/cloudflare/hono

middleware applies these headers automatically, so there’s nothing extra to call.

Other improvements

For a complete list of bug fixes and smaller improvements, see the full changelog.

Community

The Astro core team is:

Alexander Niebuhr, Armand Philippot, Chris Swithinbank, Emanuele Stoppa, Erika, Florian Lefebvre, Fred Schott, HiDeoo, Luiz Ferraz, Matt Kane, Matthew Phillips, Reuben Tier, Sarah Rainsberger, and Yan Thomas.

Special thanks to everyone who contributed to Astro 7.3 with code, docs, reviews, and testing, including:

Aleksandr Smyshliaev, Alisson Nunes, Angel Marfil, angelo 🦈, Arnold, Ashleigh Yeoman, Barry, bulebrainbrand, Chuck Reynolds, Constantine, Daniel, Dawid Gaweł, Eknath, Eric Clemmons, Eric Park, Espen Hovlandsdal, Ethan Stoner, Felix Schneider, fkatsuhiro, Jawad Ali, Johannes Grof │ Dev, Junseong Park, Kesley David, Konrad Szajna, Kosta, Kynson Szetau, Lazizbek Ergashev, ld-web, Linserin Yang, Louis Escher, markws62, Marnik Bercx, Martin Trapp, Miklós Csepella, Miodrag Obradovic, mkismy, Ngo Quoc Viet, ocavue, paul valladares, Roman, Sakku 🦉, Sebastiaan Saarloos, Shinya Fujino, swaggysnippets, Tarik Ermis, thelazylama, Thomas Bonnet, tianrking, Ujjwal Gupta, Wahid Rizka Fathurrohman, Waqas Ahmed, Yoann Fleury, and 翠

We hope you enjoy Astro 7.3. If you run into issues or want to share feedback, please join us on Discord, post on GitHub, or reach out on Bluesky, Twitter, and Mastodon.