NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm
npm, #4883 most downloaded on npm
Internal helpers used by core Astro packages.
Latest stable
0.13.2
Last release 12 days ago
10 Nov 2026
Ships fairly regularly
a new release about every 3 weeks
Nearly every release is documented
notes for 32 of 33 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
43 releases · first in 2023
Drag across the ruler to compare, or tap a release to open it.
### Patch Changes - #18695 `57137ed` Thanks @matthewp! - Adds the @astrojs/internal-helpers/renderer export used by @astrojs/react, @astrojs/preact, @
`7da442b` Thanks @matthewp! - Fixes the image endpoint treating directories whose names differ only by letter case as being inside the build output di
Your coding agent can read these notes before it upgrades. Set up the MCP server →
### Minor Changes - #17894 `b7a1bd9` Thanks @Princesseuh! - Adds the measurements that astro build --timings reports for Markdown processing and synta
b7a1bd9 Thanks @Princesseuh! - Adds the measurements that astro build --timings reports for Markdown processing and syntax highlighting.1cc5b7890 Thanks @natemoo-re! - Update supported node versions. Minimum versions are now node@14.20.0 or node@16.16.0.### Minor Changes - #18099 `6987261` Thanks @renovate! - Adds YAML parsing with timestamp and merge key support, and formats YAML errors consistently
c8f5fa35 Thanks @bholmesdev! - Add "initialize git repository" step to simplify our next steps suggestion. We now give you a one-liner to easily paste in your terminal and start the dev server!### Minor Changes - #17262 `f8e9458` Thanks @Princesseuh! - Adds an @astrojs/internal-helpers/mdx entrypoint with the shared helpers the Markdown proc
f8e9458 Thanks @Princesseuh! - Adds an @astrojs/internal-helpers/mdx entrypoint with the shared helpers the Markdown processor packages use to render .mdx files.b7cd6958 Thanks @bholmesdev! - Replace the component framework selector with a new "run astro add" option. This unlocks integrations beyond components during your create-astro setup, including TailwindCSS and Partytown. This also replaces our previous "starter" template with a simplified "Just the basics" option.### Patch Changes - #17701 `05763a0` Thanks @matthewp! - Fixes base path stripping to respect path-segment boundaries. With a configured base such as
### Patch Changes - #17696 `8c193f6` Thanks @astrobot-houston! - Fixes incremental build cache invalidation caused by Shiki mutating the langAlias con
8c193f6 Thanks @astrobot-houston! - Fixes incremental build cache invalidation caused by Shiki mutating the langAlias config object when loading languages### Patch Changes - #17474 `c895b12` Thanks @nicksnyder! - Updates dependency js-yaml to v4.3.0
c895b12 Thanks @nicksnyder! - Updates dependency js-yaml to v4.3.0With trailingSlash: 'always', the standalone Node server could append a trailing slash to a request path that begins with a backslash (for example /\e
#17252 eb6f97e Thanks @matthewp! - Fixes trailing-slash handling for request paths that begin with a backslash
With trailingSlash: 'always', the standalone Node server could append a trailing slash to a request path that begins with a backslash (for example /\example.com/foo) and echo that path back in the Location header of a 301 response. Because browsers resolve a leading \ the same way as /, the resulting Location could point off-site.
Such paths are now recognized as internal paths, matching the existing handling for paths that begin with //, so they are no longer rewritten with a trailing slash.
00fc1326 Thanks @bholmesdev! - Simplify logging during welcome message and directory selection## 0.10.0 ### Minor Changes - #16848 `f732f3c` Thanks @Princesseuh! - Adds markdown, frontmatter, and shiki helper modules, shared by Astro's content
f732f3c Thanks @Princesseuh! - Adds markdown, frontmatter, and shiki helper modules, shared by Astro's content pipeline.38e5e9e9 Thanks @bholmesdev! - Feat: add option to install dependencies during setup. This respects the package manager used to run create-astro (ex. "yarn create astro" vs "pnpm create astro@latest").### Patch Changes - #16544 `d365c97` Thanks @matthewp! - Tightens isRemotePath() to reject control characters after a leading slash and fixes the dev
### Minor Changes - #16419 `f3485c3` Thanks @matthewp! - Hardens nested object and package metadata lookups to ignore prototype keys in content handli
7c49194c Thanks @bholmesdev! - Add prompt to choose a directory, now defaulting to a separate "./my-astro-site" instead of "." (current directory)The minimum supported Node.js version is now 22.22.0, the latest Node.js 22 release supported by StackBlitz. This change is in line with Astro's Node.
#18277 2715958 Thanks @florian-lefebvre! - Increases the minimum Node.js version to 22.22.0
The minimum supported Node.js version is now 22.22.0, the latest Node.js 22 release supported by StackBlitz. This change is in line with Astro's Node.js support policy.
#15778 4ebc1e3 Thanks @ematipico! - Added a new entry point called /request, which exposes utilities to work with the Request type:
getFirstForwardedValue: retrieves the first value of a multi-value header.isValidIpAddress: checks whether a string contains only characters valid in IPv4/IPv6 addresses.getValidatedIpFromHeader: extracts the first value from a header and validates it as an IP address.getClientIpAddress: retrieves and validates the first IP from the x-forwarded-for header.#15077 a164c77 Thanks @matthewp! - Adds normalizePathname() utility function for normalizing URL pathnames to match the canonical form used by route generation.
#15419 a18d727 Thanks @ematipico! - Adds a new /cli specifier and the utility NPM_PACKAGE_NAME_REGEX.
#15369 240c317 Thanks @florian-lefebvre! - BREAKING CHANGE
Removes collapseDuplicateSlashes(), startsWithForwardSlash(), startsWithDotDotSlash(), startsWithDotSlash() and isAbsolutePath() from the /path export
#15771 745e632 Thanks @rururux! - Adds the new utilities MANY_LEADING_SLASHES and collapseDuplicateLeadingSlashes.
getFirstForwardedValue: retrieves the first value of a multi-value header.
4ebc1e3 Thanks @ematipico! - Added a new entry point called /request, which exposes utilities to work with the Request type:
getFirstForwardedValue: retrieves the first value of a multi-value header.isValidIpAddress: checks whether a string contains only characters valid in IPv4/IPv6 addresses.getValidatedIpFromHeader: extracts the first value from a header and validates it as an IP address.getClientIpAddress: retrieves and validates the first IP from the x-forwarded-for header.### Minor Changes - #15771 `745e632` Thanks @rururux! - Adds the new utilities MANY_LEADING_SLASHES and collapseDuplicateLeadingSlashes.
### Minor Changes - #15077 `a164c77` Thanks @matthewp! - Adds normalizePathname() utility function for normalizing URL pathnames to match the canonica
Removes collapseDuplicateSlashes(), startsWithForwardSlash(), startsWithDotDotSlash(), startsWithDotSlash() and isAbsolutePath() from the /path export
#15369 240c317 Thanks @florian-lefebvre! - BREAKING CHANGE
Removes collapseDuplicateSlashes(), startsWithForwardSlash(), startsWithDotDotSlash(), startsWithDotSlash() and isAbsolutePath() from the /path export
Nothing published for this version
### Patch Changes - #17651 `504333c` Thanks @sxzz! - Refactors internal version handling to use a smaller, ESM-native dependency
#14791 9e9c528 Thanks @Princesseuh! - Changes the remote protocol checks for images to require explicit authorization in order to use data URIs.
In order to allow data URIs for remote images, you will need to update your astro.config.mjs file to include the following configuration:
// astro.config.mjs
import { defineConfig } from 'astro/config';
export default defineConfig({
images: {
remotePatterns: [
{
protocol: 'data',
},
],
},
});
#14787 0f75f6b Thanks @matthewp! - Fixes wildcard hostname pattern matching to correctly reject hostnames without dots
Previously, hostnames like localhost or other single-part names would incorrectly match patterns like *.example.com. The wildcard matching logic has been corrected to ensure that only valid subdomains matching the pattern are accepted.
### Patch Changes - #17579 `3ea55ce` Thanks @bluwy! - Supports the devEngines field in package.json when detecting the package manager for install com
### Patch Changes - #17188 `675d11d` Thanks @astrobot-houston! - Fixes @astrojs/upgrade showing a generic error when pnpm's minimumReleaseAge policy b
675d11d Thanks @astrobot-houston! - Fixes @astrojs/upgrade showing a generic error when pnpm's minimumReleaseAge policy blocks installation. The error message now explains that pnpm's policy blocked the update and suggests running the install command manually.### Patch Changes - #16424 `3fcdaf1` Thanks @matthewp! - Improves how @astrojs/upgrade spawns package manager commands so it uses the same Windows com
4d16de7 Thanks @ematipico! - Improves the detection of remote paths in the _image endpoint. Now href parameters that start with // are considered remote paths.`0567fb7` Thanks @ascorbic! - Adds // to list of internal path prefixes that do not have automated trailing slash handling
### Minor Changes - #14169 `f4e8889` Thanks @ascorbic! - Adds isInternalPath helper
45cea6ae Thanks @jonathantneal! - Officially drop support for Node v12. The minimum supported version is now Node v14.15+,### Patch Changes - #13355 `042d1de` Thanks @ematipico! - Adds documentation to the assets utilities for remote service images.
042d1de Thanks @ematipico! - Adds documentation to the assets utilities for remote service images.This adds logic to filter remote URLs so that it can be used by both astro and @astrojs/markdown-remark.
### Patch Changes - #13130 `b71bd10` Thanks @ascorbic! - Fixes a bug that meant that internal as well as trailing duplicate slashes were collapsed
### Minor Changes - #12994 `5361755` Thanks @ascorbic! - Adds collapseDuplicateTrailingSlashes function
### Patch Changes - #17946 `3fd16ee` Thanks @odysseus0! - Fix syntax highlighting for fenced code blocks when raw HTML is enabled. - #18046 `8358d59`
#17946 3fd16ee Thanks @odysseus0! - Fix syntax highlighting for fenced code blocks when raw HTML is enabled.
#18046 8358d59 Thanks @Princesseuh! - Fixes satteriHeadingIdsPlugin sharing Slugger state across documents when reused as a user hast plugin, which caused headings with the same text in different posts to receive incorrect numeric suffixes
### Patch Changes - #17896 `a548223` Thanks @matthewp! - Fixes / rendering in MDX so that only literal content (including content injected by remark/r
a548223 Thanks @matthewp! - Fixes <script>/<style> rendering in MDX so that only literal content (including content injected by remark/rehype plugins) is treated as trusted markup. A dynamic value passed as a <script>/<style> child (e.g. <script>{value}</script>) is now escaped like any other element's content instead of being rendered raw. Use set:html to explicitly opt a dynamic value back into raw rendering.Both processors now compile .mdx files themselves. You still need to install @astrojs/mdx to add MDX support to your project.
#17262 f8e9458 Thanks @Princesseuh! - Adds MDX rendering to the unified() and satteri() processors.
Both processors now compile .mdx files themselves. You still need to install @astrojs/mdx to add MDX support to your project.
f8e9458]:
20463a6c1e1271d8dc3cb0ab3419ee5c72abd218 Thanks @Princesseuh! - Add removeBase functioncreate-astro to handle framework-specific logic based on user preference```js // astro.config.mjs import { satteri } from '@astrojs/markdown-satteri';
#16969 4a31f90 Thanks @Princesseuh! - Adds support for Prism syntax highlighting to the Sätteri Markdown and MDX processors. Setting markdown.syntaxHighlight to 'prism' now highlights your code blocks with Prism.
// astro.config.mjs
import { satteri } from '@astrojs/markdown-satteri';
export default defineConfig({
markdown: {
processor: satteri(),
syntaxHighlight: 'prism',
},
});
#10189 1ea0a25b94125e4f6f2ac82b42f638e22d7bdffd Thanks @peng! - Adds the option to pass an object to build.assetsPrefix. This allows for the use of multiple CDN prefixes based on the target file type.
When passing an object to build.assetsPrefix, you must also specify a fallback domain to be used for all other file types not specified.
Specify a file extension as the key (e.g. 'js', 'png') and the URL serving your assets of that file type as the value:
// astro.config.mjs
import { defineConfig } from 'astro/config';
export default defineConfig({
build: {
assetsPrefix: {
js: 'https://js.cdn.example.com',
mjs: 'https://js.cdn.example.com', // if you have .mjs files, you must add a new entry like this
png: 'https://images.cdn.example.com',
fallback: 'https://generic.cdn.example.com',
},
},
});
### Patch Changes - #16883 `eeb064c` Thanks @Princesseuh! - Fixes missing provenance information on the publish
eeb064c Thanks @Princesseuh! - Fixes missing provenance information on the publish6f60da805 Thanks @ematipico! - Add provenance statement when publishing the library from CISätteri is much faster than the default Remark-based processor, and supports a wide range of Markdown features out of the box, without requiring addit
#16848 f732f3c Thanks @Princesseuh! - Adds @astrojs/markdown-satteri, a Markdown processor based on Sätteri, a fast Markdown pipeline written in Rust.
Sätteri is much faster than the default Remark-based processor, and supports a wide range of Markdown features out of the box, without requiring additional plugins. In the future, we plan to make this the default Markdown processor in Astro.
npm install @astrojs/markdown-satteri
// astro.config.mjs
import { satteri } from '@astrojs/markdown-satteri';
export default defineConfig({
markdown: {
processor: satteri(),
},
});
Note that this processor currently does not support Prism syntax highlighting, and require using syntaxHighlight: 'shiki' or disabling syntax highlighting altogether for now.
f732f3c]:
cea7da5 Thanks @Princesseuh! - Adds the initial release of the TypeScript content mapper for Astro files.#8188 d0679a666 Thanks @ematipico! - Remove support for Node 16. The lowest supported version by Astro and all integrations is now v18.14.1. As a reminder, Node 16 will be deprecated on the 11th September 2023.
#8179 6011d52d3 Thanks @matthewp! - Astro 3.0 Release Candidate
### Minor Changes - #8179 `6011d52d3` Thanks @matthewp! - Astro 3.0 Release Candidate
### Patch Changes - #8062 `2aa6d8ace` Thanks @bluwy! - Trigger re-release to fix collapseDuplicateSlashes export
The lowest supported version by Astro and all integrations is now v18.14.1. As a reminder, Node 16 will be deprecated on the 11th September 2023.
1eae2e3f7 Thanks @Princesseuh! - Remove support for Node 16. The lowest supported version by Astro and all integrations is now v18.14.1. As a reminder, Node 16 will be deprecated on the 11th September 2023.### Patch Changes - #18713 `59052e7` Thanks @delucis! - Unpins @astrojs/* dependencies to allow versions matching the ^ range to be installed
6035bb35f Thanks @natemoo-re! - Add collapseDuplicateSlashes helperUpdated dependencies [`e9916e1`]:
e9916e1]:
57137ed]:
Updated dependencies [`c904827`, `5083c65`, `1999c84`, `f98e8a8`, `f98e8a8`]:
#18611 f98e8a8 Thanks @matthewp! - Adds standalone rendering: astro() compiles .astro files in a plain Vite project, and renderToString() / renderToResponse() from @astrojs/runtime render a component tree with its stylesheets, scripts and framework islands in dev and in builds
#18611 f98e8a8 Thanks @matthewp! - Adds declarative renderer fields: an AstroRenderer can carry options (passed to its server entrypoint as this.options), optimizeDeps, dedupe, noExternal (a list, or a function of the project root for lists found by crawling dependencies), a dev-only devHeadScript and an appEntrypoint that its entrypoints import, which astro() applies, so a renderer is plain data next to the framework's own Vite plugin
#18611 f98e8a8 Thanks @matthewp! - Adds standalone rendering: astro() compiles .astro files in a plain Vite project, and renderToString() / renderToResponse() from @astrojs/runtime render a component tree with its stylesheets, scripts and framework islands in dev and in builds
#18611 f98e8a8 Thanks @matthewp! - Adds declarative renderer fields: an AstroRenderer can carry options (passed to its server entrypoint as this.options), optimizeDeps, dedupe, noExternal (a list, or a function of the project root for lists found by crawling dependencies), a dev-only devHeadScript and an appEntrypoint that its entrypoints import, which astro() applies, so a renderer is plain data next to the framework's own Vite plugin
#18630 c904827 Thanks @astro-factory! - Fixes bundled scripts and hydrated islands being blocked when security.csp.scriptDirective.strictDynamic is enabled. Astro now adds the hash of every bundled script to script-src and renders an import map with their integrity in the <head>.
#18688 1999c84 Thanks @astro-factory! - Fixes errors thrown after a page has started streaming bypassing the configured logger. They are now reported once through it, as one error record, in both production and astro dev
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.