AstroEco is Releasing…

Patch Changes

• #15415 cc3c46c Thanks @ematipico! - Fixes an issue where CSP headers were incorrectly injected in the development server.

• #15412 c546563 Thanks @florian-lefebvre! - Improves the AstroAdapter type and how legacy adapters are handled

• #15421 bf62b6f Thanks @Princesseuh! - Removes unintended logging

Major Changes

• #15400 41eb284 Thanks @florian-lefebvre! - Removes the workerEntryPoint option, which wasn't used anymore. Set the main field of your wrangler config instead

  See how to migrate

Patch Changes

• Updated dependencies []:
  • @astrojs/underscore-redirects@1.0.0

Minor Changes

• #15258 d339a18 Thanks @ematipico! - Stabilizes the adapter feature experimentalStatiHeaders. If you were using this feature in any of the supported adapters, you'll need to change the name of the flag:

  export default defineConfig({
    adapter: netlify({
  -    experimentalStaticHeaders: true
  +    staticHeaders: true
    })
  })

Minor Changes

• #15258 d339a18 Thanks @ematipico! - Stabilizes the adapter feature experimentalStatiHeaders. If you were using this feature in any of the supported adapters, you'll need to change the name of the flag:

  export default defineConfig({
    adapter: netlify({
  -    experimentalStaticHeaders: true
  +    staticHeaders: true
    })
  })

Patch Changes

• #15167 4fca170 Thanks @HiDeoo! - Fixes an issue where CSS from unused components, when using content collections, could be incorrectly included between page navigations in development mode.

• #15268 54e5cc4 Thanks @rururux! - fix: avoid creating unused images during build in Picture component

• #15133 53b125b Thanks @HiDeoo! - Fixes an issue where adding or removing <style> tags in Astro components would not visually update styles during development without restarting the development server.

• Updated dependencies [80f0225]:

  • @astrojs/markdown-remark@7.0.0-beta.5

Minor Changes

• #15258 d339a18 Thanks @ematipico! - Stabilizes the adapter feature experimentalStatiHeaders. If you were using this feature in any of the supported adapters, you'll need to change the name of the flag:

  export default defineConfig({
    adapter: netlify({
  -    experimentalStaticHeaders: true
  +    staticHeaders: true
    })
  })

Minor Changes

• #15258 d339a18 Thanks @ematipico! - Stabilizes the adapter feature experimentalStatiHeaders. If you were using this feature in any of the supported adapters, you'll need to change the name of the flag:

  export default defineConfig({
    adapter: netlify({
  -    experimentalStaticHeaders: true
  +    staticHeaders: true
    })
  })

Patch Changes

• Updated dependencies []:
  • @astrojs/underscore-redirects@1.0.0

Patch Changes

• #15297 80f0225 Thanks @rururux! - Fixes a case where code blocks generated by prism would include the is:raw attribute in the final output

Patch Changes

• Updated dependencies [80f0225]:
  • @astrojs/markdown-remark@7.0.0-beta.5

Patch Changes

• Updated dependencies [80f0225]:
  • @astrojs/markdown-remark@7.0.0-beta.5

Patch Changes

• Updated dependencies [240c317]:
  • @astrojs/internal-helpers@0.8.0-beta.0

Patch Changes

• Updated dependencies [240c317]:
  • @astrojs/internal-helpers@0.8.0-beta.0

Patch Changes

• #15383 876b664 Thanks @matthewp! - Fixes Preact components failing to render when using the Cloudflare adapter in dev mode.

Minor Changes

• #14888 4cd3fe4 Thanks @OliverSpeir! - Updates astro add cloudflare to better setup types, by adding ./worker-configuration.d.ts to tsconfig includes and a generate-types script to package.json

• #15349 a257c4c Thanks @ascorbic! - Passes collection name to live content loaders

  Live content collection loaders now receive the collection name as part of their parameters. This is helpful for loaders that manage multiple collections or need to differentiate behavior based on the collection being accessed.

  export function storeLoader({ field, key }) {
    return {
      name: 'store-loader',
      loadCollection: async ({ filter, collection }) => {
        // ...
      },
      loadEntry: async ({ filter, collection }) => {
        // ...
      },
    };
  }

Patch Changes

• #15394 5520f89 Thanks @florian-lefebvre! - Fixes a case where using the Fonts API with netlify dev wouldn't work because of query parameters

• #15385 9e16d63 Thanks @matthewp! - Fixes content layer loaders that use dynamic imports

  Content collection loaders can now use await import() and import.meta.glob() to dynamically import modules during build. Previously, these would fail with "Vite module runner has been closed."

• #15386 a0234a3 Thanks @OliverSpeir! - Updates astro add cloudflare to use the latest valid compatibility_date in the wrangler config, if available

• #15362 dbf71c0 Thanks @jcayzac! - Fixes inferSize being kept in the HTML attributes of the emitted <img> when that option is used with an image that is not remote.

• Updated dependencies [240c317]:

  • @astrojs/internal-helpers@0.8.0-beta.0
  • @astrojs/markdown-remark@7.0.0-beta.4

Patch Changes

• Updated dependencies [240c317]:
  • @astrojs/internal-helpers@0.8.0-beta.0
  • @astrojs/underscore-redirects@1.0.0

Patch Changes

• #15373 14252b2 Thanks @renovate! - Updates zod to v4

Minor Changes

• #15369 240c317 Thanks @florian-lefebvre! - BREAKING CHANGE

  Removes collapseDuplicateSlashes(), startsWithForwardSlash(), startsWithDotDotSlash(), startsWithDotSlash() and isAbsolutePath() from the /path export

Patch Changes

• #15391 5d996cc Thanks @florian-lefebvre! - Fixes types of the handle() function exported from /handler, that could be incompatible with types generated by wrangler types

• #15386 a0234a3 Thanks @OliverSpeir! - Updates astro add cloudflare to use the latest valid compatibility_date in the wrangler config, if available

• Updated dependencies [240c317]:

  • @astrojs/internal-helpers@0.8.0-beta.0
  • @astrojs/underscore-redirects@1.0.0

Patch Changes

• Updated dependencies []:
  • @astrojs/markdown-remark@7.0.0-beta.4

Patch Changes

• #15344 9d87f77 Thanks @matthewp! - Fixes a hang that could occur when the npm registry is slow or unresponsive by adding a 10 second timeout to the version check

• #15350 d758b68 Thanks @matthewp! - Errors when --add and --no-install flags are used together, as --add requires dependencies to be installed

Patch Changes

• Updated dependencies [240c317]:
  • @astrojs/internal-helpers@0.8.0-beta.0

Patch Changes

• #15373 14252b2 Thanks @renovate! - Updates zod to v4

Patch Changes

• #15335 75931c2 Thanks @matthewp! - Fixes an issue where spreading a built-in Markdoc node config (e.g., ...Markdoc.nodes.fence) and specifying a custom render component would not work because the built-in transform() function was overriding the custom component. Now, render wins over transform when both are specified.

• Updated dependencies [240c317]:

  • @astrojs/internal-helpers@0.8.0-beta.0
  • @astrojs/markdown-remark@7.0.0-beta.4

Patch Changes

• #15373 14252b2 Thanks @renovate! - Updates zod to v4

Patch Changes

• #3645 a562096 Thanks @mschoeffmann! - Adds icons for Chrome, Edge, Firefox, and Safari

Major Changes

• #15332 7c55f80 Thanks @matthewp! - Adds frontmatter parsing support to renderMarkdown in content loaders. When markdown content includes frontmatter, it is now extracted and available in metadata.frontmatter, and excluded from the HTML output. This makes renderMarkdown behave consistently with the glob loader.

  const loader = {
    name: 'my-loader',
    load: async ({ store, renderMarkdown }) => {
      const content = `---
  title: My Post
  ---
  
  # Hello World
  `;
      const rendered = await renderMarkdown(content);
      // rendered.metadata.frontmatter is now { title: 'My Post' }
      // rendered.html contains only the content, not the frontmatter
    },
  };

Minor Changes

• #15291 89b6cdd Thanks @florian-lefebvre! - Removes the experimental.fonts flag and replaces it with a new configuration option fonts - (v6 upgrade guidance)

• #15332 7c55f80 Thanks @matthewp! - Adds a fileURL option to renderMarkdown in content loaders, enabling resolution of relative image paths. When provided, relative image paths in markdown will be resolved relative to the specified file URL and included in metadata.localImagePaths.

  const loader = {
    name: 'my-loader',
    load: async ({ store, renderMarkdown }) => {
      const content = `
  # My Post
  
  ![Local image](./image.png)
  `;
      // Provide a fileURL to resolve relative image paths
      const fileURL = new URL('./posts/my-post.md', import.meta.url);
      const rendered = await renderMarkdown(content, { fileURL });
      // rendered.metadata.localImagePaths now contains the resolved image path
    },
  };

• #15291 89b6cdd Thanks @florian-lefebvre! - Adds a new Fonts API to provide first-party support for adding custom fonts in Astro.

  This feature allows you to use fonts from both your file system and several built-in supported providers (e.g. Google, Fontsource, Bunny) through a unified API. Keep your site performant thanks to sensible defaults and automatic optimizations including preloading and fallback font generation.

  To enable this feature, configure fonts with one or more fonts:

  import { defineConfig, fontProviders } from 'astro/config';
  
  export default defineConfig({
    fonts: [
      {
        provider: fontProviders.fontsource(),
        name: 'Roboto',
        cssVariable: '--font-roboto',
      },
    ],
  });

  Import and include the <Font /> component with the required cssVariable property in the head of your page, usually in a dedicated Head.astro component or in a layout component directly:

  ---
  // src/layouts/Layout.astro
  import { Font } from 'astro:assets';
  ---
  
  <html>
    <head>
      <Font cssVariable="--font-roboto" preload />
    </head>
    <body>
      <slot />
    </body>
  </html>

  In any page rendered with that layout, including the layout component itself, you can now define styles with your font's cssVariable to apply your custom font.

  In the following example, the <h1> heading will have the custom font applied, while the paragraph <p> will not.

  ---
  // src/pages/example.astro
  import Layout from '../layouts/Layout.astro';
  ---
  
  <Layout>
    <h1>In a galaxy far, far away...</h1>
  
    <p>Custom fonts make my headings much cooler!</p>
  
    <style>
      h1 {
        font-family: var('--font-roboto');
      }
    </style>
  </Layout>

  Visit the updated fonts guide to learn more about adding custom fonts to your project.

Patch Changes

• #15337 7ff7b11 Thanks @ematipico! - Fixes a bug where the development server couldn't serve newly created new pages while the development server is running.

• #15331 4592be5 Thanks @matthewp! - Fixes an issue where API routes would overwrite public files during build. Public files now correctly take priority over generated routes in both dev and build modes.

• Updated dependencies [7c55f80]:

  • @astrojs/markdown-remark@7.0.0-beta.3

Patch Changes

• Updated dependencies [7c55f80]:
  • @astrojs/markdown-remark@7.0.0-beta.3

Patch Changes

• #15336 9cce92e Thanks @ascorbic! - Fixes a dev server issue where framework components from linked packages would fail to load with a 504 error.

  This could occur when using client:only or other client directives with components from monorepo packages (linked via file: or workspace protocol). The first request would trigger Vite's dependency optimizer mid-request, causing concurrent client module requests to fail.

• Updated dependencies []:

  • @astrojs/underscore-redirects@1.0.0

Minor Changes

• #15332 7c55f80 Thanks @matthewp! - Exposes the fileURL option in MarkdownProcessorRenderOptions, allowing callers to specify the file URL for resolving relative image paths.

Patch Changes

• #3675 0ba556d Thanks @controversial! - Excludes the accessible labels for heading anchor links from Pagefind results

Patch Changes

• #15334 d715f1f Thanks @florian-lefebvre! - BREAKING CHANGE to the experimental Fonts API only

  Removes the getFontBuffer() helper function exported from astro:assets when using the experimental Fonts API

  This experimental feature introduced in v15.6.13 ended up causing significant memory usage during build. This feature has been removed and will be reintroduced after further exploration and testing.

  If you were relying on this function, you can replicate the previous behavior manually:

  • On prerendered routes, read the file using node:fs
  • On server rendered routes, fetch files using URLs from fontData and context.url

Patch Changes

• #15309 4b9c8b8 Thanks @ematipico! - Update the underneath @cloudflare/workers-types library to address a warning emitted by the package manager during the installation.

• #15255 a66783a Thanks @florian-lefebvre! - Fixes a case where the types of handle() could mismatch with the ones from the user's project. They now rely on globals, that can be obtained by running wrangler types

• Updated dependencies []:

  • @astrojs/underscore-redirects@1.0.0

Minor Changes

• #15312 72f7960 Thanks @ocavue! - Update @vitejs/plugin-react to v5.

Patch Changes

• #15283 daf41c6 Thanks @eldair! - Updates validation to use Zod v4

Minor Changes

• #14821 48ea241 Thanks @ocavue! - Update @sveltejs/vite-plugin-svelte to v6.

Patch Changes

• #3534 703fab0 Thanks @HiDeoo! - Fixes support for running builds when npx is unavailable.

  Previously, Starlight would spawn a process to run the Pagefind search indexing binary using npx. On platforms where npx isn’t available, this could cause issues. Starlight now runs Pagefind using its Node.js API to avoid a separate process. As a side effect, you may notice that logging during builds is now less verbose.

• #3656 a0e6368 Thanks @delucis! - Fixes several edge cases in highlighting the current page heading in Starlight’s table of contents

• #3663 00cbf00 Thanks @lines-of-codes! - Adds Thai language support

• #3658 ac79329 Thanks @delucis! - Avoids adding redundant aria-current="false" attributes to sidebar entries

• #3382 db295c2 Thanks @trueberryless! - Fixes an issue where the mobile table of contents is unable to find the first heading when a page has a tall banner.

Patch Changes

• #15264 11efb05 Thanks @florian-lefebvre! - Lower the Node version requirement to allow running on Stackblitz until it supports v22

Patch Changes

• #15264 11efb05 Thanks @florian-lefebvre! - Lower the Node version requirement to allow running on Stackblitz until it supports v22

Patch Changes

• #15264 11efb05 Thanks @florian-lefebvre! - Lower the Node version requirement to allow running on Stackblitz until it supports v22

Patch Changes

• #15264 11efb05 Thanks @florian-lefebvre! - Lower the Node version requirement to allow running on Stackblitz until it supports v22

• Updated dependencies [cb99214, 11efb05]:

  • @astrojs/markdown-remark@7.0.0-beta.2
  • @astrojs/prism@4.0.0-beta.2

Patch Changes

• #15264 11efb05 Thanks @florian-lefebvre! - Lower the Node version requirement to allow running on Stackblitz until it supports v22

• Updated dependencies [cb99214]:

  • @astrojs/markdown-remark@7.0.0-beta.2

Patch Changes

• #15264 11efb05 Thanks @florian-lefebvre! - Lower the Node version requirement to allow running on Stackblitz until it supports v22

Patch Changes

• #15264 11efb05 Thanks @florian-lefebvre! - Lower the Node version requirement to allow running on Stackblitz until it supports v22

Patch Changes

• #15264 11efb05 Thanks @florian-lefebvre! - Lower the Node version requirement to allow running on Stackblitz until it supports v22

Minor Changes

• #15277 cb99214 Thanks @ematipico! - Fixes an issue where the function createShikiHighlighter would always create a new Shiki highlighter instance. Now the function returns a cached version of the highlighter based on the Shiki options. This should improve the performance for sites that heavily rely on Shiki and code in their pages.

Patch Changes

• Updated dependencies [11efb05]:
  • @astrojs/prism@4.0.0-beta.2

Patch Changes

• #15264 11efb05 Thanks @florian-lefebvre! - Lower the Node version requirement to allow running on Stackblitz until it supports v22

Patch Changes

• #15198 55107a1 Thanks @HiDeoo! - Updates to Astro 6 beta

Patch Changes

• #15269 6f82aae Thanks @ematipico! - Fixes a regression where build.serverEntry stopped working as expected.

• Updated dependencies []:

  • @astrojs/underscore-redirects@1.0.0

Minor Changes

• #15069 d14dfc2 Thanks @webstackdev! - Adds a --db-app-token CLI flag to astro db commands execute, push, query, and verify

  The new Astro DB CLI flags allow you to provide a remote database app token directly instead of ASTRO_DB_APP_TOKEN. This ensures that no untrusted code (e.g. CI / CD workflows) has access to the secret that is only needed by the astro db commands.

  The following command can be used to safely push database configuration changes to your project database:

  astro db push --db-app-token <token>
  

  See the Astro DB integration documentation for more information.

Patch Changes

• #14863 29fd188 Thanks @drwpow! - Improves error message when using Node builtins inside Edge middlewares

Minor Changes

• #14471 4296373 Thanks @Slackluky! - Adds the ability to split sitemap generation into chunks based on customizable logic. This allows for better management of large sitemaps and improved performance. The new chunks option in the sitemap configuration allows users to define functions that categorize sitemap items into different chunks. Each chunk is then written to a separate sitemap file.

  integrations: [
    sitemap({
      serialize(item) { th
        return item
      },
      chunks: { // this property will be treated last on the configuration
        'blog': (item) => {  // will produce a sitemap file with `blog` name (sitemap-blog-0.xml)
          if (/blog/.test(item.url)) { // filter path that will be included in this specific sitemap file
            item.changefreq = 'weekly';
            item.lastmod = new Date();
            item.priority = 0.9; // define specific properties for this filtered path
            return item;
          }
        },
        'glossary': (item) => {
          if (/glossary/.test(item.url)) {
            item.changefreq = 'weekly';
            item.lastmod = new Date();
            item.priority = 0.7;
            return item;
          }
        }
  
        // the rest of the path will be stored in `sitemap-pages.0.xml`
      },
    }),
  ],
  
  

Patch Changes

• #15196 a8317c1 Thanks @ematipico! - Fixes an issue where some prendered pages weren't correctly rendered when using the Node.js adapter in middleware mode.

• #15169 b803d8b Thanks @rururux! - fix: fix image 500 error when moving dist directory in standalone Node

Patch Changes

• #15199 d8e64ef Thanks @ArmandPhilippot! - Fixes the links to Astro Docs so that they match the current docs structure.

Patch Changes

• #15199 d8e64ef Thanks @ArmandPhilippot! - Fixes the links to Astro Docs so that they match the current docs structure.

• Updated dependencies []:

  • @astrojs/underscore-redirects@1.0.0

Patch Changes

• #15199 d8e64ef Thanks @ArmandPhilippot! - Fixes the links to Astro Docs so that they match the current docs structure.

Patch Changes

• #3648 292666c Thanks @maxchang3! - Prevents unwanted font size adjustments on iOS after orientation changes.

Patch Changes

• #15187 bbb5811 Thanks @matthewp! - Update to Astro 6 beta

Patch Changes

• #15187 bbb5811 Thanks @matthewp! - Update to Astro 6 beta

Patch Changes

• #15187 bbb5811 Thanks @matthewp! - Update to Astro 6 beta

Patch Changes

• #15187 bbb5811 Thanks @matthewp! - Update to Astro 6 beta

• Updated dependencies [bbb5811]:

  • @astrojs/language-server@2.16.1-beta.1

Patch Changes

• #15187 bbb5811 Thanks @matthewp! - Update to Astro 6 beta

• Updated dependencies []:

  • @astrojs/underscore-redirects@1.0.0

Patch Changes

• Updated dependencies [bbb5811, bbb5811]:
  • @astrojs/markdown-remark@7.0.0-beta.1
  • @astrojs/prism@4.0.0-beta.1

Patch Changes

• #15187 bbb5811 Thanks @matthewp! - Update to Astro 6 beta

Patch Changes

• #15187 bbb5811 Thanks @matthewp! - Update to Astro 6 beta

Patch Changes

• #15187 bbb5811 Thanks @matthewp! - Update to Astro 6 beta

Patch Changes

• #15187 bbb5811 Thanks @matthewp! - Update to Astro 6 beta

Patch Changes

• #15187 bbb5811 Thanks @matthewp! - Update to Astro 6 beta

Patch Changes

• #15187 bbb5811 Thanks @matthewp! - Update to Astro 6 beta

Patch Changes

• #15187 bbb5811 Thanks @matthewp! - Update to Astro 6 beta

Patch Changes

• #15187 bbb5811 Thanks @matthewp! - Update to Astro 6 beta

• Updated dependencies [bbb5811]:

  • @astrojs/prism@4.0.0-beta.1

Patch Changes

• #15187 bbb5811 Thanks @matthewp! - Update to Astro 6 beta

Patch Changes

• #15187 bbb5811 Thanks @matthewp! - Update to Astro 6 beta

• Updated dependencies [bbb5811]:

  • @astrojs/markdown-remark@7.0.0-beta.1

Patch Changes

• #15125 6feb0d7 Thanks @florian-lefebvre! - Improve Svelte children prop type checking

Patch Changes

• #15125 6feb0d7 Thanks @florian-lefebvre! - Updates Node versions data to account for v24 as the default

Patch Changes

• #15125 6feb0d7 Thanks @florian-lefebvre! - Adds support for arbitrary HTML attributes on Vue components

Patch Changes

• #15164 54dc11d Thanks @HiDeoo! - Fixes an issue where the Node.js adapter could fail to serve a 404 page matching a pre-rendered dynamic route pattern.

Patch Changes

• #15156 9cc2c71 Thanks @Princesseuh! - Fixes TypeScript plugin not working

Patch Changes

• #15131 d40ff7d Thanks @Princesseuh! - Fixes extension asking for the wrong version of VS Code

Patch Changes

• #15033 dd06779 Thanks @florian-lefebvre! - Updates how routes are retrieved to avoid relying on a deprecated API

Patch Changes

• #15083 241bb31 Thanks @fkatsuhiro! - Fix "Find All References" and other TypeScript features by ensuring the plugin bundle is correctly included

• #15109 e062101 Thanks @Princesseuh! - Fixes syntax highlighting sometimes not working when the frontmatter or script tags ended with certain TypeScript constructs

Patch Changes

• #15116 9fc4562 Thanks @Raanelom! - Updates Node versions data to account for v24 as the default

Patch Changes

• #15016 12eb4cd Thanks @rahuld109! - Adds support for arbitrary HTML attributes on Vue components

Patch Changes

• #15070 fa9c464 Thanks @antonyfaris! - Improve Svelte children prop type checking

Patch Changes

• #3647 9f4efc3 Thanks @gerstenbergit! - Adds Greek language support