Never miss a release that matters
AI-powered summaries of every GitHub release.
AI Summaries
Changelogs condensed into clear, actionable insights.
Always Free
Track up to 5 packages at no cost, forever.
Weekly Digest
A curated summary of every release, delivered weekly.
TL;DR
Astro introduces significant performance and scalability improvements for large content collections and enhanced security controls for CSP.
New
- Content Layer Optimizations: Added
deferRendertoglob()to reduce memory usage during builds and an experimentalchunkedstorage option to prevent large data-store files from hitting platform limits. - Granular CSP Control: Added support for specific CSP (Content Security Policy) directives like
script-src-elemandstyle-src-attrvia a newkindoption.
Fixes Worth Knowing
- Dev Experience: Fixed an immediate full-page reload on the first browser visit and resolved issues where
astro dev --forcefailed to replace running servers. - Hydration: Client islands now recover from transient import failures during development.
- Routing: Fixed incorrect routing for encoded request paths when using domain-based i18n.
- MDX: Fixed custom
precomponents not applying to syntax-highlighted blocks when using the Sätteri processor.
TL;DR
Astro sites deployed to Netlify now correctly handle periods and other special characters in image remote patterns, preventing unexpected matching of image sources.
Fixes Worth Knowing
Image remote patterns (defining allowed image sources) now function as expected with special characters, ensuring only explicitly allowed domains and paths are matched for image optimization via Netlify’s CDN (Content Delivery Network).
TL;DR
Astro’s TypeScript compatibility is improved: astro check now provides a helpful error message instead of crashing when used with the latest TypeScript compiler (TypeScript 7).
Fixes Worth Knowing
astro check no longer crashes with TypeScript 7. It now displays a clear error message guiding users to a tracking issue for updates on full compatibility (static analysis tool).
TL;DR
Astro Cloudflare adapter now correctly handles custom image services and build-time environment variables, and fixes issues with preview opening and React island hydration, improving build reliability and developer experience.
Fixes Worth Knowing
astro preview --opennow reliably opens a browser window when using the Cloudflare adapter.- Custom image services (for image optimization) are now correctly applied, even when registered through integrations.
- Build-time environment variables (
astro:env) are now correctly loaded and available during the build process. - React "Invalid hook call" errors in islands are resolved by prebundling necessary modules.
TL;DR
Sätteri Markdown (Astro’s Markdown processor) now correctly applies custom components to syntax-highlighted code blocks within MDX files.
Fixes Worth Knowing
Custom pre components now function as expected with syntax highlighting when using Sätteri Markdown and MDX. This ensures consistent styling of code blocks throughout your Astro site.
TL;DR
Astro’s telemetry now uses a more reliable method for detecting your package manager (npm, yarn, pnpm) and operating system, improving accuracy for users on Windows Subsystem for Linux (WSL).
Fixes Worth Knowing
Package manager and WSL detection have been improved, resolving potential issues with telemetry reporting and ensuring accurate data collection.
TL;DR
This release updates dependencies across Astro’s React and Preact integrations, ensuring compatibility and stability for projects using these frameworks (JavaScript UI libraries).
Fixes Worth Knowing
Dependency updates resolve underlying issues and improve the reliability of React and Preact components within Astro projects.
TL;DR
Astro’s Node and Vercel adapters now correctly handle request paths starting with a backslash, preventing incorrect redirects to external sites when using trailingSlash: 'always'.
Fixes Worth Knowing
- Fixed an issue where the Node and Vercel adapters had incorrect
peerDependencies(package dependencies), which could cause installation problems. - The Node adapter no longer appends trailing slashes to internal paths beginning with a backslash, resolving potential redirect issues.
TL;DR
create-astro now correctly supports projects behind proxies, enabling wider adoption for users in corporate or restricted network environments.
Fixes Worth Knowing
- Proxy support is improved by respecting
HTTP_PROXYandHTTPS_PROXYenvironment variables. - Dependency installation issues with pnpm 11+ are resolved.
TL;DR
TypeScript support in Astro is improved, allowing "Go To References" to correctly find usages of code within Astro components when using Astro.locals (Astro’s component properties).
Fixes Worth Knowing
The "Go To References" feature now works as expected for TypeScript code used inside Astro components via Astro.locals, improving the developer experience when navigating code.
TL;DR
Astro projects using Svelte have a dependency issue resolved, ensuring Svelte components (user interface framework) function correctly.
Fixes Worth Knowing
- Corrected
peerDependenciesto ensure compatibility with Svelte projects.
TL;DR
RSS feed generation is now more robust, correctly handling special characters in feed content like titles and enclosure types.
Fixes Worth Knowing
RSS feeds now properly escape special characters in source and enclosure fields, preventing potential parsing issues with feed readers (software that reads RSS).
TL;DR
Astro 7.0 beta introduces stable route caching with a simplified configuration, and changes default HTML compression to use JSX rules, potentially altering whitespace in your rendered output.
Breaking
- HTML Compression: Astro now uses JSX rules for whitespace compression by default. This may change rendered output. Set
compressHTML: trueorfalseinastro.config.mjsto revert to previous behavior. - Container API Import: If using the Container API with integrations like React, Vue, or SolidJS, update your import statements to use the
/container-rendererentrypoint (e.g.,@astrojs/react/container-renderer).
New
- Stable Route Caching: Route caching is now stable, offering a platform-agnostic way to cache on-demand rendered pages and endpoints using standard HTTP caching semantics. Configure using the top-level
cacheandrouteRulesoptions inastro.config.mjs.
Fixes Worth Knowing
- Fixed issues with custom 500 error pages not rendering correctly in advanced routing scenarios (Hono/Fetch).
- Resolved a bug where internal Astro headers were leaking from direct
pages()handler responses. - Improved build performance by optimizing head metadata propagation.
Before You Upgrade
- If you rely on specific whitespace in your HTML, explicitly set
compressHTML: trueorcompressHTML: falseinastro.config.mjs. - Update import statements for the Container API to use the
/container-rendererentrypoint if applicable.
TL;DR
Sätteri, the Markdown rendering engine used by Astro, has been updated to version 0.9.0, potentially improving Markdown compatibility and rendering quality.
Fixes Worth Knowing
Updates to the underlying Sätteri library may resolve some edge cases in Markdown rendering, though specific fixes are detailed in the Sätteri changelog (Markdown processing tool).
TL;DR
Astro Cloudflare deployments are significantly faster due to optimizations in the astro sync process, reducing build times.
Fixes Worth Knowing
astro sync is now faster by avoiding unnecessary Cloudflare runtime startup during type generation. This improves the development experience when using Cloudflare as a deployment target (cloud computing platform).
TL;DR
New Astro projects now include starter documentation for using Astro Agents (AI-powered tools) with instructions and links to get started.
New
- New projects include
AGENTS.mdand aCLAUDE.mdsymlink to help developers quickly learn about and utilize Astro Agents.
TL;DR
Update your imports if you directly use the getContainerRenderer function (Container API) from @astrojs/react, @astrojs/preact, or other supported integrations, moving it to the /container-renderer subdirectory.
Breaking
getContainerRendererimport path: You must update imports to'@astrojs/react/container-renderer'(or similar for other integrations) to avoid future deprecation warnings. (API function for rendering components)
Before You Upgrade
- If you import
getContainerRendererfrom@astrojs/reactor@astrojs/preact, change the import path as described in the breaking changes section.
TL;DR
Astro projects using the Container API (for integrating UI frameworks) should update their import statements to use the new /container-renderer entrypoint for improved performance and to avoid future deprecation warnings.
Breaking
- Update imports for
getContainerRenderer()to use/container-renderer(API for UI framework integration).
TL;DR
Astro packages are now releasing beta versions, previously stuck on alpha, allowing for broader testing and feedback before final release.
Before You Upgrade
If you are using @astrojs/vercel or @astrojs/node and rely on pre-release versions, be aware that you are now receiving beta builds instead of alpha builds.
TL;DR
Astro Markdoc now supports beta releases, allowing earlier access to new features and improvements for content-focused projects (content rendering pipeline).
Breaking
- Markdoc packages previously on alpha are now on beta (potentially changes build process).
TL;DR
Astro sites deployed to Netlify will now benefit from improved support for packages transitioning from alpha to beta releases.
Fixes Worth Knowing
Netlify deployments now correctly trigger beta prereleases for packages previously in alpha, ensuring you receive the latest features and improvements as they stabilize. (Prereleases: test versions of software)
TL;DR
Astro now supports Alpine.js (a lightweight JavaScript framework) via @astrojs/alpinejs, enabling you to add dynamic behavior to your static sites.
New
- Added
@astrojs/alpinejssupport for integrating Alpine.js into Astro projects.
TL;DR
This release improves performance and stability for Astro deployments on Cloudflare Workers by automatically caching static assets and resolving a critical build crash when using advanced routing.
Fixes Worth Knowing
- Fixed an issue where
astro/fetchandastro/hono(web standards for data fetching) were not correctly pre-bundled, leading to slower development server startup. - Corrected a documentation link to point to the correct issue tracker.
- Resolved a build error when using advanced routing with a custom
fetchFilefunction.
TL;DR
Astro Node adapter now correctly serves prerendered pages with clean URLs when using build.format: 'file' or build.format: 'preserve', and startup messages are now correctly routed to your configured logger destination (logging configuration).
Fixes Worth Knowing
- Prerendered pages using clean URLs (e.g.,
/about) now resolve to.htmlfiles when usingbuild.format: 'file'orbuild.format: 'preserve'with the Node adapter in standalone mode. - Startup messages are now correctly sent to the configured logger destination (logging system).
TL;DR
Astro’s Node adapter now allows configuring a maximum request body size (default 1GB) and has improved CSRF protection and static file handling. The Vercel adapter now provides explicit control over the client IP address in edge middleware.
Breaking
- The
experimentalErrorPageHostoption in the Node adapter has been removed. You must now implement custom error page fetching via middleware if you previously relied on this feature. (Configuration option for fetching error pages from a different host)
New
- Node Adapter: Configure
bodySizeLimitto restrict maximum request body size. (Configuration setting, bytes) - Vercel Adapter: Access
clientAddressin edge middleware for more accurate client IP information. (Middleware context property)
Fixes Worth Knowing
- CSRF origin checks in the Node adapter are now more accurate, especially when using a specific port.
- Static file handling in the Node adapter is more consistent.
- Static headers are correctly applied when using a
basepath. - Static file path resolution is hardened for security.
TL;DR
The Cloudflare adapter now correctly handles static site deployments and accurately determines client IP addresses, improving security and reliability.
Fixes Worth Knowing
- Duplicate logging during prerendering is resolved.
- Static site deployments with
output: 'static'now function as expected. - Client IP address detection is more accurate and prevents potential injection attacks (security feature).
TL;DR
Astro RSS feed generation now uses an updated fast-xml-parser library, improving parsing reliability and security.
Fixes Worth Knowing
- Updated the
fast-xml-parserdependency (XML parsing library) to version 5.3.6, addressing potential vulnerabilities and improving stability when generating RSS feeds.
TL;DR
The @astrojs/sitemap package now uses Zod v4 (data validation library), improving performance and type safety for sitemap generation.
Breaking
- Zod v4 dependency (requires compatible integrations)
Fixes Worth Knowing
None.
Before You Upgrade
Ensure any integrations using Zod are compatible with version 4.
TL;DR
Astro sites deployed to Cloudflare Pages will now benefit from improved asset handling, leading to faster load times.
New
- Updated dependencies to improve stability and performance.
Fixes Worth Knowing
- Asset handling on Cloudflare Pages is improved. (Cloudflare Pages is a web hosting service)
Before You Upgrade
- No action is needed to benefit from these changes.