@astrojs/vercel

• 11.0.11

  Sep 22, 2026

  🐞 Patch Changes

  • #18044 98c07e1 Thanks @astro-factory! - Fixes a rare issue where ISR pages on Vercel could intermittently be served a cached redirect to a nonsense URL (such as /$0/) instead of the page itself. Pages now render correctly, and requests that can’t be resolved to a valid path return a 404 instead of a redirect.

  • #18008 a09b328 Thanks @yanthomasdev! - Fixes the immutable Cache-Control rule for hashed assets (/_astro/*) being emitted after the filesystem route handle in .vercel/output/config.json.

• 11.0.10

  Sep 3, 2026

  🐞 Patch Changes

  • #17818 c0b6581 Thanks @florian-lefebvre! - Updates the development image service to forward every argument it receives to Astro’s Sharp service, including the new logger parameter
• 11.0.9

  Aug 31, 2026

  🐞 Patch Changes

  • #17450 19dae21 Thanks @ocavue! - Updates dependency @vercel/analytics to v2. See the changelog for more details. Updates dependency @vercel/routing-utils to v6. See the changelog for more details.
  • Updated dependencies [f8e9458]:
    • @astrojs/internal-helpers@0.11.0
• 11.0.8

  Aug 24, 2026

  🐞 Patch Changes

  • #17794 dd29ce8 Thanks @astro-factory! - Fixes a bug where @vercel/nft file tracing silently dropped all dependency files when outDir was configured outside root, causing deployed functions to crash with ERR_MODULE_NOT_FOUND
• 11.0.7

  Aug 19, 2026

  🐞 Patch Changes

  • #17687 0a22ff5 Thanks @asmyshlyaev177! - Fixes middlewareMode: 'edge' not running your middleware when isr is also enabled

    Previously, enabling both options deployed the edge middleware but never reached it: requests went straight to the ISR function, which skips rendering entirely on a cache hit. Middleware now runs at the edge for ISR-backed routes before the cached response is served, and query strings are preserved when it forwards the request.

  • Updated dependencies [05763a0]:

    • @astrojs/internal-helpers@0.10.4
• 11.0.6

  Aug 18, 2026

  🐞 Patch Changes

  • #17680 ce9f1da Thanks @astrobot-houston! - Fixes server islands returning 404 responses in Vercel deployments using output: "static"

  • Updated dependencies [8c193f6]:

    • @astrojs/internal-helpers@0.10.3
• 11.0.5

  Aug 6, 2026

  🐞 Patch Changes

  • #17569 d1bb7fa Thanks @lazerg! - Prevents astro build from crashing with EEXIST when .vercel/output/server/ already exists by creating it with { recursive: true }, matching the sibling static/ directory call
• 11.0.4

  Jul 28, 2026

  🐞 Patch Changes

  • Updated dependencies [c895b12]:
    • @astrojs/internal-helpers@0.10.2
• 11.0.3

  Jul 13, 2026

  🐞 Patch Changes

  • #17370 3a43cf0 Thanks @matthewp! - Improves internal ISR route handling
• 11.0.2

  Jul 2, 2026

  🐞 Patch Changes

  • Updated dependencies [eb6f97e]:
    • @astrojs/internal-helpers@0.10.1
• 11.0.1

  Jul 1, 2026

  🐞 Patch Changes

  • #17249 02b73b0 Thanks @ematipico! - Fixes an issue where the peerDependencies field used incorrect dependencies.
• 11.0.0

  Jun 22, 2026

  ✨ Major Changes

  • #15819 cafec4e Thanks @delucis! - Upgrade to Vite v8

  🍿 Minor Changes

  • #16335 9a53f77 Thanks @ascorbic! - Adds a CDN cache provider for Astro route caching on Vercel

    Setup

    Import cacheVercel() from @astrojs/vercel/cache and set it as your cache provider:

    import { defineConfig } from 'astro/config';
    import vercel from '@astrojs/vercel';
    import { cacheVercel } from '@astrojs/vercel/cache';
    
    export default defineConfig({
      adapter: vercel(),
      cache: {
        provider: cacheVercel(),
      },
    });

    Caching responses

    Use Astro.cache.set() in your pages and API routes to cache responses on Vercel’s edge network. The provider sets Vercel-CDN-Cache-Control and Vercel-Cache-Tag headers on responses.

    ---
    Astro.cache.set({ maxAge: 300, tags: ['products'] });
    const data = await fetchProducts();
    ---
    
    <ProductList items={data} />

    You can also set cache rules for groups of routes in your config:

    cache: { provider: cacheVercel() },
    routeRules: {
      '/products/[...slug]': { maxAge: 3600, tags: ['products'] },
      '/api/[...path]': { maxAge: 60, swr: 600 },
    },

    Invalidation

    Purge cached responses by tag or path from any API route or server endpoint:

    export async function POST({ request, cache }) {
      await cache.invalidate({ tags: ['products'] });
      return new Response('Purged');
    }
    
    // Path-based invalidation
    await cache.invalidate({ path: '/products/123' });

    Both tag-based and path-based invalidation are supported. Tag invalidation is a soft invalidation, marking cached responses as stale so they can be revalidated in the background via stale-while-revalidate.

  🐞 Patch Changes

  • #17027 241250b Thanks @ocavue! - Triggers beta prereleases for packages that are still on alpha
• 11.0.0-beta.1

  Jun 13, 2026

  🐞 Patch Changes

  • #17027 241250b Thanks @ocavue! - Triggers beta prereleases for packages that are still on alpha
• 10.0.8

  May 28, 2026

  🐞 Patch Changes

  • Updated dependencies [f732f3c]:
    • @astrojs/internal-helpers@0.10.0
• 10.0.7

  May 13, 2026

  🐞 Patch Changes

  • Updated dependencies [d365c97]:
    • @astrojs/internal-helpers@0.9.1
• 11.0.0-alpha.0

  Apr 30, 2026

  ✨ Major Changes

  • #15819 cafec4e Thanks @delucis! - Upgrade to Vite v8

  🐞 Patch Changes

  • Updated dependencies [cafec4e, cafec4e, c30a778, ee079d4]:
    • astro@7.0.0-alpha.0
• 10.0.6

  Apr 28, 2026

  🐞 Patch Changes

  • #16486 0bae1a5 Thanks @cyphercodes! - Fix forwarded serverless requests with streamed bodies by preserving the required duplex: 'half' option when rewriting middleware paths.
• 10.0.5

  Apr 22, 2026

  🐞 Patch Changes

  • Updated dependencies [99464ed, f3485c3]:
    • @astrojs/internal-helpers@0.9.0
• 10.0.4

  Apr 1, 2026

  🐞 Patch Changes

  • #16170 d0fe1ec Thanks @bittoby! - Fixes edge middleware next() dropping the HTTP method and body when forwarding requests to the serverless function, which caused non-GET API routes (POST, PUT, PATCH, DELETE) to return 404
• 10.0.3

  Mar 26, 2026

  🐞 Patch Changes

  • #16079 aa26636 Thanks @empoulter-uclan! - Fix vercel ISR path rewrite