AstroEco is Releasing…

Patch Changes

• #14286 09c5db3 Thanks @ematipico! - BREAKING CHANGES only to the experimental CSP feature

  The following runtime APIs of the Astro global have been renamed:

  • Astro.insertDirective to Astro.csp.insertDirective
  • Astro.insertStyleResource to Astro.csp.insertStyleResource
  • Astro.insertStyleHash to Astro.csp.insertStyleHash
  • Astro.insertScriptResource to Astro.csp.insertScriptResource
  • Astro.insertScriptHash to Astro.csp.insertScriptHash

  The following runtime APIs of the APIContext have been renamed:

  • ctx.insertDirective to ctx.csp.insertDirective
  • ctx.insertStyleResource to ctx.csp.insertStyleResource
  • ctx.insertStyleHash to ctx.csp.insertStyleHash
  • ctx.insertScriptResource to ctx.csp.insertScriptResource
  • ctx.insertScriptHash to ctx.csp.insertScriptHash

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

• #14275 3e2f20d Thanks @florian-lefebvre! - Adds support for experimental CSP when using experimental fonts

  Experimental fonts now integrate well with experimental CSP by injecting hashes for the styles it generates, as well as font-src directives.

  No action is required to benefit from it.

• #14280 4b9fb73 Thanks @ascorbic! - Fixes a bug that caused cookies to not be correctly set when using middleware sequences

• #14276 77281c4 Thanks @ArmandPhilippot! - Adds a missing export for resolveSrc, a documented image services utility.

Patch Changes

• #14039 da4182d Thanks @ematipico! - Fixes a bug where experimentalStaticHeaders did not work as expected.

• #14289 ed493a6 Thanks @ascorbic! - Fixes a bug that caused invalid image sizes to be generated when the requested widths were larger than the source image

Patch Changes

• #14281 dfd88de Thanks @ascorbic! - Fixes a regression that broke sites that used the compile image service without nodejs_compat set

• Updated dependencies []:

  • @astrojs/underscore-redirects@1.0.0

Patch Changes

• #14269 4823c42 Thanks @florian-lefebvre! - Updates context.netlify to implement all its properties

• Updated dependencies []:

  • @astrojs/underscore-redirects@1.0.0

Patch Changes

• 9ecf359 Thanks @alexanderniebuhr! - Improves the image proxy endpoint when using the default compile option to adhere to user configuration regarding the allowed remote domains

• Updated dependencies []:

  • @astrojs/underscore-redirects@1.0.0

Patch Changes

• #14260 86a1e40 Thanks @jp-knj! - Fixes Astro.url.pathname to respect trailingSlash: 'never' configuration when using a base path. Previously, the root path with a base would incorrectly return /base/ instead of /base when trailingSlash was set to 'never'.

• #14248 e81c4bd Thanks @julesyoungberg! - Fixes a bug where actions named 'apply' do not work due to being a function prototype method.

Patch Changes

• #14239 d7d93e1 Thanks @wtchnm! - Fixes a bug where the types for the live content collections were not being generated correctly in dev mode

• #14221 eadc9dd Thanks @delucis! - Fixes JSON schema support for content collections using the file() loader

• #14229 1a9107a Thanks @jonmichaeldarby! - Ensures Astro.currentLocale returns the correct locale during SSG for pages that use a locale param (such as [locale].astro or [locale]/index.astro, which produce [locale].html)

Patch Changes

• #14240 77b18fb Thanks @delucis! - Increases the minimum supported version of Astro to 5.7.0

Patch Changes

• #14233 896886c Thanks @gouravkhunger! - Fixes the issue with the option lastmod where if it is defined it applies correctly to <url> entries in each sitemap-${i}.xml file but not the <sitemap> entries in the root sitemap-index.xml file.

Patch Changes

• #14240 77b18fb Thanks @delucis! - Increases the minimum supported version of Astro to 5.7.0

• Updated dependencies []:

  • @astrojs/underscore-redirects@1.0.0

Patch Changes

• #14259 02366e9 Thanks @ascorbic! - Removes warning when using the adapter with a static build.

  The Cloudflare adapter now has several uses outside of on-demand rendered pages, so this warning is misleading. Similar warnings have already been removed from other adapters.

• #14234 15b55f3 Thanks @yanthomasdev! - Fixes an issue that could cause duplicate exports when configuring workerEntrypoint.namedExports

• #14240 77b18fb Thanks @delucis! - Increases the minimum supported version of Astro to 5.7.0

• Updated dependencies []:

  • @astrojs/underscore-redirects@1.0.0

Patch Changes

• #14241 760acc8 Thanks @ematipico! - Fixes an issue where remote paths weren't correctly computed when generating assets

Patch Changes

• Updated dependencies [4d16de7]:
  • @astrojs/internal-helpers@0.7.2

Patch Changes

• Updated dependencies [4d16de7]:
  • @astrojs/internal-helpers@0.7.2
  • @astrojs/underscore-redirects@1.0.0

Patch Changes

• Updated dependencies [4d16de7]:
  • @astrojs/internal-helpers@0.7.2

Patch Changes

• Updated dependencies [4d16de7]:
  • @astrojs/internal-helpers@0.7.2
  • @astrojs/markdown-remark@6.3.6

Patch Changes

• Updated dependencies [4d16de7]:
  • @astrojs/internal-helpers@0.7.2
  • @astrojs/underscore-redirects@1.0.0

Patch Changes

• 4d16de7 Thanks @ematipico! - Improves the detection of remote paths in the _image endpoint. Now href parameters that start with // are considered remote paths.

Patch Changes

• Updated dependencies []:
  • @astrojs/markdown-remark@6.3.6

Patch Changes

• Updated dependencies [4d16de7]:
  • @astrojs/internal-helpers@0.7.2

Patch Changes

• 4d16de7 Thanks @ematipico! - Improves the detection of remote paths in the _image endpoint. Now href parameters that start with // are considered remote paths.

• Updated dependencies [4d16de7]:

  • @astrojs/internal-helpers@0.7.2
  • @astrojs/markdown-remark@6.3.6

Patch Changes

• 5fc3c59 Thanks @ematipico! - Fixes a routing bug in standalone mode with trailingSlash set to "always".

Minor Changes

• #13682 5824b32 Thanks @gouravkhunger! - Adds a customSitemaps option to include extra sitemaps in the sitemap-index.xml file generated by Astro.

  This is useful for multi-framework setups on the same domain as your Astro site (example.com), such as a blog at example.com/blog whose sitemap is generated by another framework.

  The following example shows configuring your Astro site to include sitemaps for an externally-generated blog and help center along with the generated sitemap entries in sitemap-index.xml:

  Example:

  import { defineConfig } from 'astro/config';
  import sitemap from '@astrojs/sitemap';
  
  export default defineConfig({
    site: 'https://example.com',
    integrations: [
      sitemap({
        customSitemaps: [
          'https://example.com/blog/sitemap.xml',
          'https://example.com/helpcenter/sitemap.xml',
        ],
      }),
    ],
  });

  Learn more in the @astrojs/sitemap configuration documentation.

Patch Changes

• #14207 91283b5 Thanks @Adammatthiesen! - Fixes inferred types for Astro DB tables using column.text fields.

Patch Changes

• #14066 7abde79 Thanks @alexanderniebuhr! - Refactors the internal solution which powers Astro Sessions when running local development with ˋastro devˋ.

  The adapter now utilizes Cloudflare's local support for Cloudflare KV. This internal change is a drop-in replacement and does not require any change to your projectct code.

  However, you now have the ability to connect to the remote Cloudflare KV Namespace if desired and use production data during local development.

• Updated dependencies []:

  • @astrojs/underscore-redirects@1.0.0

Minor Changes

• #14190 438adab Thanks @Adammatthiesen! - Adds support for enum support for text columns in Astro DB tables.

  import { column, defineTable } from 'astro:db';
  
  // Table definition
  const UserTable = defineTable({
    columns: {
      id: column.number({ primaryKey: true }),
      name: column.text(),
      rank: column.text({ enum: ['user', 'mod', 'admin'] }),
    },
  });
  
  // Resulting type definition
  type UserTableInferInsert = {
    id: string;
    name: string;
    rank: 'user' | 'mod' | 'admin';
  };

Minor Changes

• #14188 e3422aa Thanks @ascorbic! - Adds support for specifying a host to load prerendered error pages

  By default, if a user defines a custom error page that is prerendered, Astro will load it from the same host as the one that the request is made to. This change allows users to specify a different host for loading prerendered error pages. This can be useful in scenarios such as where the server is running behind a reverse proxy or when prerendered pages are hosted on a different domain.

  To use this feature, set the experimentalErrorPageHost adapter option in your Astro configuration to the desired host URL. For example, if your server is running on localhost and served via a proxy, you can ensure the prerendered error pages are fetched via the localhost URL:

  import { defineConfig } from 'astro/config';
  import node from '@astrojs/node';
  export default defineConfig({
    adapter: node({
      // If your server is running on localhost and served via a proxy, set the host like this to ensure prerendered error pages are fetched via the localhost URL
      experimentalErrorPageHost: 'http://localhost:4321',
    }),
  });

  For more information on enabling and using this experimental feature, see the @astrojs/node adapter docs.

Patch Changes

• #14175 1e1cef0 Thanks @ematipico! - Fixes a bug where the adapter would cause a runtime error when calling astro build in CI environments.

Patch Changes

• #14186 9fe883e Thanks @Adammatthiesen! - Fixes types for optional and primary key columns in Astro DB tables.

Patch Changes

• Updated dependencies [0567fb7]:
  • @astrojs/internal-helpers@0.7.1

Minor Changes

• #13894 b36e72f Thanks @florian-lefebvre! - Removes support for Astro Studio

  Astro Studio has been discontinued since September 2024. If you still haven't migrated yet to Turso, check our guide.

Patch Changes

• Updated dependencies [0567fb7]:
  • @astrojs/internal-helpers@0.7.1
  • @astrojs/markdown-remark@6.3.5

Patch Changes

• Updated dependencies []:
  • @astrojs/markdown-remark@6.3.5

Patch Changes

• #14174 2002512 Thanks @ascorbic! - Retry installation with --legacy-peer-deps if npm has peer dep error

Patch Changes

• Updated dependencies [0567fb7]:
  • @astrojs/internal-helpers@0.7.1

Patch Changes

• Updated dependencies [0567fb7]:
  • @astrojs/internal-helpers@0.7.1
  • @astrojs/underscore-redirects@1.0.0

Patch Changes

• Updated dependencies [0567fb7]:
  • @astrojs/internal-helpers@0.7.1

Patch Changes

• 0567fb7 Thanks @ascorbic! - Adds // to list of internal path prefixes that do not have automated trailing slash handling

Patch Changes

• Updated dependencies [f4e8889]:
  • @astrojs/internal-helpers@0.7.0
  • @astrojs/markdown-remark@6.3.4

Patch Changes

• Updated dependencies [f4e8889]:
  • @astrojs/internal-helpers@0.7.0

Minor Changes

• #14169 f4e8889 Thanks @ascorbic! - Adds isInternalPath helper

Patch Changes

• Updated dependencies []:
  • @astrojs/markdown-remark@6.3.4

Patch Changes

• #14158 89e9364 Thanks @bjohansebas! - Prevents deprecation warnings in Node 24

Patch Changes

• #14158 89e9364 Thanks @bjohansebas! - Prevents deprecation warnings in Node 24

Patch Changes

• #14147 211968c Thanks @birtles! - Recognize a custom default image node component

Patch Changes

• #3341 10f6fe2 Thanks @HiDeoo! - Prevents potential build issues with the Astro Cloudflare adapter due to the dependency on Node.js builtins.

• #3327 bf58c60 Thanks @delucis! - Fixes a routing bug for docs pages with a slug authored with non-normalized composition. This could occur for filenames containing diacritics in some circumstances, causing 404s.

Patch Changes

• #14127 2309ada Thanks @florian-lefebvre! - Upgrades zod

Patch Changes

• #14127 2309ada Thanks @florian-lefebvre! - Upgrades zod

Minor Changes

• #14115 270e009 Thanks @ascorbic! - Removes "Open in x" badges from the README of the official Astro templates when a new project is created

• #14115 270e009 Thanks @ascorbic! - Adds support for marking sections in template READMEs to be removed when the create astro command is used to create a new project

  Theme authors can now use magic comments in template READMEs to mark sections that should not be included when a user runs create-astro with the --template flag to create a new project.

  This allows templates to have content that is visible when viewed in the source repo but not when the template is copied for use in a new project. This is useful for content that is appropriate for a theme's own repository, but will not be useful to someone using the theme, such as
  an "Open this repository in StackBlitz" badge where the URL is hardcoded .

  Use the magic comments <!-- ASTRO:REMOVE:START --> and <!-- ASTRO:REMOVE:END --> to indicate content to be excluded from your README during the create astro process.

  <!-- ASTRO:REMOVE:START -->
  
  [![Open in StackBlitz](https://developer.stackblitz.com/img/open_in_stackblitz.svg)](https://stackblitz.com/github/withastro/astro/tree/latest/examples/basics)
  
  <!-- ASTRO:REMOVE:END -->

  Note that these comments only remove content when new projects are created using create astro. When your theme template is forked, your README will be copied in its entirety.

   🐞 Bug Fixes

• Update deps to fix #34 (incl. Astro 5.11.1 → 5.12.1) & minor style tweaks  -  by @lin-stephanie in #34 (1cc27)

    View changes on GitHub

Patch Changes

• #14077 42ef004 Thanks @jat001! - Changes the default Node.js version of Vercel functions to 22

Patch Changes

• Exit early in 'repoList' mode when GitHub token is missing (e2fdc33)

Patch Changes

• #3325 4cf28f2 Thanks @mniinio! - Adds Finnish language support

Patch Changes

• Updated dependencies [6bd5f75]:
  • @astrojs/markdown-remark@6.3.3

Patch Changes

• #13941 6bd5f75 Thanks @aditsachde! - Adds support for TOML files to Astro's built-in glob() and file() content loaders.

  In Astro 5.2, Astro added support for using TOML frontmatter in Markdown files instead of YAML. However, if you wanted to use TOML files as local content collection entries themselves, you needed to write your own loader.

  Astro 5.12 now directly supports loading data from TOML files in content collections in both the glob() and the file() loaders.

  If you had added your own TOML content parser for the file() loader, you can now remove it as this functionality is now included:

  // src/content.config.ts
  import { defineCollection } from "astro:content";
  import { file } from "astro/loaders";
  - import { parse as parseToml } from "toml";
  const dogs = defineCollection({
  -  loader: file("src/data/dogs.toml", { parser: (text) => parseToml(text) }),
  + loader: file("src/data/dogs.toml")
    schema: /* ... */
  })

  Note that TOML does not support top-level arrays. Instead, the file() loader considers each top-level table to be an independent entry. The table header is populated in the id field of the entry object.

  See Astro's content collections guide for more information on using the built-in content loaders.

Patch Changes

• Updated dependencies [6bd5f75]:
  • @astrojs/markdown-remark@6.3.3

   🚀 Features

• page: Add /photos page to create your personal gallery  -  by @lin-stephanie in #31 (ebcff)

   🐞 Bug Fixes

• photos:
  • Dynamically adjust image auto-load threshold (distanceToBottom) based on viewport height (fix #33)  -  by @lin-stephanie (76920)
  • Stabilize masonry placeholders; delay lightbox image; drop redundant img attrs  -  by @lin-stephanie (c924f)
  • Restore smooth scroll; hide scrollbar in image viewer without layout shift; unify scrollbar style  -  by @lin-stephanie (aca66)
• Make favicon adapt to light/dark mode  -  by @lin-stephanie (ee0ec)
• Avoid showing hr without Giscus & remove Giscus lazy loading  -  by @lin-stephanie (37c72)

   💅 Refactors

• Add ImageCarousel for basic auto-play (removed swiper)  -  by @lin-stephanie (2077a)

   🏡 Chore

• Update deps, Astro 5.7.13 → 5.11.1  -  by @lin-stephanie (cb790)
• Update docs for image responsiveness and favicon  -  by @lin-stephanie (085bc)
• Update docs for new /photos page  -  by @lin-stephanie (a94ba)
• Lil typo  -  by @Draco1js in #32 (417fd)
• Optimize styles and formatting  -  by @lin-stephanie (7624e)
• Update image src  -  by @lin-stephanie (efa22)

    View changes on GitHub

Minor Changes

• #2261 778b743 Thanks @shubham-padia! - Adds support for using any of Starlight’s built-in icons in asides.

• #3272 e7fe267 Thanks @delucis! - Adds a new generateId option to Starlight’s docsLoader()

  This enables overriding the default sluggifier used to convert content filenames to URLs.

• #3276 3917b20 Thanks @delucis! - Excludes banner content from search results

  Previously, content set in banner in page frontmatter was indexed by Starlight’s default search provider Pagefind. This could cause unexpected search results, especially for sites setting a common banner content on multiple pages. Starlight’s default Banner component is now excluded from search indexing.

  This change does not impact Banner overrides using custom components.

• #3266 1161af0 Thanks @HiDeoo! - Adds support for custom HTML attributes on autogenerated sidebar links using the autogenerate.attrs option.

• #3274 80ccff7 Thanks @HiDeoo! - Fixes an issue where some Starlight remark and rehype plugins were transforming Markdown and MDX content in non-Starlight pages.

  ⚠️ BREAKING CHANGE:

  Previously, some of Starlight’s remark and rehype plugins, most notably the plugin transforming Starlight's custom Markdown syntax for rendering asides, were applied to all Markdown and MDX content. This included content from individual Markdown pages and content from content collections other than the docs collection used by Starlight.

  This change restricts the application of Starlight’s remark and rehype plugins to only Markdown and MDX content loaded using Starlight's docsLoader(). If you were relying on this behavior, please let us know about your use case in the dedicated #starlight channel in the Astro Discord or by opening an issue.

Patch Changes

• #3266 1161af0 Thanks @HiDeoo! - Ensures invalid sidebar group configurations using the attrs option are properly reported as a type error.

  Previously, invalid sidebar group configurations using the attrs option were not reported as a type error but only surfaced at runtime. This change is only a type-level change and does not affect the runtime behavior of Starlight which does not support the attrs option for sidebar groups.

• #3274 80ccff7 Thanks @HiDeoo! - Prevents Starlight remark and rehype plugins from transforming Markdown and MDX content when using the Astro renderMarkdown() content loader API.

Minor Changes

• #2261 778b743 Thanks @shubham-padia! - Adds support for the icon attribute in the aside tag, allowing the use of any of Starlight’s built-in icons.

Patch Changes

• #3306 21fcd94 Thanks @HiDeoo! - Fixes a regression in Starlight version 0.34.5 that caused multilingual sites with a default locale explicitly set to root to report a configuration error.

Patch Changes

• #3298 7bd02e3 Thanks @HiDeoo! - Fixes a potential issue with absolutePathToLang() plugin API not handling paths with spaces correctly.