what stackpulse tracks
Astro releases from GitHub
StackPulse watches Astro release notes and keeps the original source link close to every summary.
#stacks/astro/framework
Astro release notes, breaking changes, and upgrade notes.
The web framework for content-driven websites StackPulse turns upstream changelogs into scannable summaries with risky changes, deprecations, migration notes, and source links.
releases
20
breaking
5
security
0
deprecated
5
migrations
6
upgrade risk
Breaking changes and deprecations
Risky changes are separated from normal feature notes so you can scan upgrade impact before changing production dependencies.
migration notes
Source-backed next steps
Migration steps and recommended actions are only shown when the upstream release notes support them.
# latest_releases
source-backed@astrojs/upgrade@0.7.3lowfeatureJun 25, 2026
@astrojs/upgrade@0.7.3
Fixes a generic error message when pnpm's minimumReleaseAge policy blocks installation, now showing a more informative message.
affected
Users encountering pnpm's minimumReleaseAge policy blocking installation will see a clearer error message.
action
Run the install command manually if blocked by pnpm's policy.
@astrojs/markdoc@2.0.1mediumfeatureJun 25, 2026
@astrojs/markdoc@2.0.1
This patch release fixes a crash related to rendering shiki-highlighted code blocks within list items.
affected
Users who render shiki-highlighted code blocks inside list items are affected.
action
Update to v2.0.1 to resolve the crash.
astro@7.0.3mediumfeatureJun 25, 2026
astro@7.0.3
This patch release fixes bugs related to route handling in development mode, HMR for action files, and localized custom error pages in i18n projects.
affected
Users working with getStaticPaths in development mode, action files, or i18n error pages are affected.
action
Update to the latest version to benefit from these fixes.
create-astro@5.2.0mediumfeatureJun 25, 2026
create-astro@5.2.0
This release introduces a new flag to opt out of AI-related file generation when setting up an Astro project.
affected
Users who prefer not to generate AI-related files when creating new Astro projects are affected.
action
Use the --no-ai flag when running create-astro if you want to skip AI-related file generation.
release_signals
+Added a --no-ai flag to skip creation of AGENTS.md and CLAUDE.md files during project setup
@astrojs/cloudflare@14.0.1mediumfeatureJun 25, 2026
@astrojs/cloudflare@14.0.1
This release addresses memory crashes in `astro dev` for Cloudflare users on Vite 8 and fixes a React invalid hook warning during cold SSR optimizer reload.
affected
Users of `@astrojs/cloudflare` on Vite 8 and those experiencing React invalid hook warnings during cold SSR optimizer reload are affected.
action
Upgrade to version 14.0.1 to resolve these issues.
@astrojs/markdown-satteri@0.3.2mediumfeatureJun 23, 2026
@astrojs/markdown-satteri@0.3.2
Fix for headings being listed twice in page metadata when integrations like Starlight assign heading IDs before adding anchor links.
affected
Users with integrations like Starlight that assign heading IDs before anchor links may see duplicate headings in page metadata.
action
Upgrade to version 0.3.2 to fix duplicate headings in page metadata.
astro@7.0.2lowfeatureJun 23, 2026
astro@7.0.2
This release includes updated dependencies, specifically updating @astrojs/markdown-satteri to version 0.3.2.
affected
Users depending on @astrojs/markdown-satteri may be affected by the dependency update.
action
Update dependencies to ensure compatibility.
astro@7.0.1lowJun 23, 2026
astro@7.0.1
This patch release fixes several minor bugs related to `astro dev` behavior, background server issues, and responsive image CSS.
affected
Users of Warp terminal, Windows, or custom CSS layers may be affected by fixed issues.
action
Update to this patch version for fixes to background server behavior and CSS layering.
@astrojs/vue@7.0.0highbreakingdeprecationmigrationfeatureJun 22, 2026
@astrojs/vue@7.0.0
This release upgrades to Vite v8 and introduces a new entrypoint for `getContainerRenderer()` to optimize bundling.
affected
Users of `getContainerRenderer()` are affected by the deprecation and need to update their import statements.
action
Update import statements for `getContainerRenderer()` to use the new `container-renderer` entrypoint.
release_signals
-Importing `getContainerRenderer()` from the package root is deprecated and now logs a warning. Use the new `container-renderer` entrypoint instead.
!Importing `getContainerRenderer()` from the package root is deprecated.
+Upgrade to Vite v8
+New `container-renderer` entrypoint for `getContainerRenderer()`
migration_steps1 steps
- 01Update `getContainerRenderer()` imports to use the new `container-renderer` entrypoint. Example: `import { getContainerRenderer } from '@astrojs/react/container-renderer';`
create-astro@5.1.0lowfeatureJun 22, 2026
create-astro@5.1.0
This release adds a default Agents documentation file and creates a symlink for Claude documentation in new Astro projects.
affected
New Astro projects will now include additional documentation files by default.
release_signals
+Adds a default AGENTS.md file to new projects with dev server instructions and documentation links
+Creates a CLAUDE.md symlink (with hard link fallback) pointing to AGENTS.md
@astrojs/svelte@9.0.0highdeprecationmigrationfeatureJun 22, 2026
@astrojs/svelte@9.0.0
This release upgrades to Vite v8 and introduces a new entrypoint for `getContainerRenderer()` to improve bundling efficiency. It also updates the Svelte Vite plugin to version 7.
affected
Developers using `getContainerRenderer()` or relying on Vite v7 are affected.
action
Update import statements for `getContainerRenderer()` to use the new `container-renderer` entrypoint.
release_signals
!Importing `getContainerRenderer()` from the package root is deprecated and logs a warning.
+Upgrade to Vite v8
+New `container-renderer` entrypoint for `getContainerRenderer()`
+Update `@sveltejs/vite-plugin-svelte` to v7
migration_steps1 steps
- 01Update `getContainerRenderer()` import statements to use the new `container-renderer` entrypoint.
astro@7.0.0highbreakingdeprecationmigrationfeatureJun 22, 2026
astro@7.0.0
Astro 7.0.0 introduces significant changes including upgrading to Vite v8, making 'jsx' the default for HTML compression, and enabling advanced routing by default. The release also removes the `@astrojs/db` package and replaces the Go compiler with a Rust-based version.
affected
Developers using `@astrojs/db`, remark/rehype Markdown processing, or custom advanced routing configurations are affected.
action
Review and update configurations as per the migration steps provided.
release_signals
-Removes the `@astrojs/db` package and related CLI commands
-Replaces the Go compiler with a Rust-based version, which is more strict regarding invalid syntax
-Makes Sätteri the default Markdown processor, requiring manual configuration to continue using remark/rehype
-Enables advanced routing by default, requiring updates to `fetchFile` configuration
!Removes the `@astrojs/db` package
!Removes the `experimental.rustCompiler` flag
!Deprecates `markdown.remarkPlugins`, `markdown.rehypePlugins`, and `markdown.remarkRehype` options without `@astrojs/markdown-remark`
+Upgrade to Vite v8
+Makes 'jsx' the default value for `compressHTML`
+Adds background dev server management for AI coding agents
+Replaces the Go compiler with a Rust-based version
+Makes Sätteri the default Markdown processor
migration_steps4 steps
- 01Remove `@astrojs/db` from dependencies and replace it with alternatives like Node.js built-in SQLite or Drizzle ORM
- 02Remove `experimental.rustCompiler` flag from `astro.config.mjs`
- 03Install `@astrojs/markdown-remark` and configure `markdown.processor` to continue using remark/rehype
- 04Update `fetchFile` configuration for advanced routing if using a custom entrypoint
@astrojs/vercel@11.0.0highbreakingfeatureJun 22, 2026
@astrojs/vercel@11.0.0
Major upgrade to Vite v8 and introduces CDN caching for Astro routes on Vercel. Also includes beta prerelease triggers for alpha packages.
affected
Developers using @astrojs/vercel will need to update their configuration for the new cache provider and adapt to Vite v8 changes.
action
Update configuration to use the new cache provider and review project compatibility with Vite v8.
release_signals
-Upgrade to Vite v8 may require adjustments in existing projects
-Cache provider changes require configuration updates
+CDN cache provider for Astro route caching on Vercel
+Support for cache invalidation by tag or path
+Configurable cache rules for groups of routes
astro@7.0.0-beta.6highbreakingdeprecationmigrationfeatureprereleaseJun 19, 2026
astro@7.0.0-beta.6
Route caching is now stable with top-level configuration options. Also includes minor fixes for build warnings.
affected
Users using experimental route caching need to update their configuration.
action
Migrate cache configuration by moving options out of the experimental block.
release_signals
-Moved 'cache' and 'routeRules' out of 'experimental' block in configuration
!Removed 'experimental.cache' and 'experimental.routeRules' flags
+Route caching is now stable with top-level 'cache' and 'routeRules' configuration options
migration_steps1 steps
- 01Update config to move 'cache' and 'routeRules' out of the 'experimental' block
@astrojs/markdown-satteri@0.3.1-beta.2mediumfeatureprereleaseJun 19, 2026
@astrojs/markdown-satteri@0.3.1-beta.2
Updates the satteri dependency to version 0.9.0, which includes various improvements and bug fixes.
affected
Users who rely on the satteri dependency may be affected by changes in its new version.
action
Review the Sätteri changelog for details on changes and updates.
@astrojs/mdx@7.0.0-beta.4lowprereleaseJun 19, 2026
@astrojs/mdx@7.0.0-beta.4
This release updates the `satteri` dependency to version `0.9.0`, which may include internal improvements or bug fixes.
affected
Users relying on the `satteri` dependency may be affected by changes in its functionality.
action
Review the [Sätteri changelog](https://github.com/bruits/satteri/blob/main/packages/satteri/CHANGELOG.md) for details on changes in version `0.9.0`.
@astrojs/cloudflare@14.0.0-beta.3mediumfeatureprereleaseJun 19, 2026
@astrojs/cloudflare@14.0.0-beta.3
This beta release focuses on improving performance by optimizing the `astro sync` command to avoid starting the Cloudflare runtime during type generation.
affected
Developers using `astro sync` with Cloudflare integration will experience faster type generation.
action
Update to this beta version to benefit from the performance improvements in `astro sync`.
release_signals
+Optimized `astro sync` to skip starting the Cloudflare runtime during type generation, improving speed
create-astro@5.1.0-beta.0mediumfeatureprereleaseJun 19, 2026
create-astro@5.1.0-beta.0
This beta release adds a default AGENTS.md file to new projects and creates a symlink to it as CLAUDE.md.
affected
Affects users creating new Astro projects who want built-in documentation.
release_signals
+Adds default AGENTS.md file to new projects with dev server instructions
+Creates CLAUDE.md symlink (with hard link fallback) pointing to AGENTS.md
@astrojs/react@6.0.0-beta.2mediumdeprecationmigrationfeatureprereleaseJun 18, 2026
@astrojs/react@6.0.0-beta.2
This release introduces a new container-renderer entrypoint for getContainerRenderer() to optimize bundling. Import paths have been updated for better bundler efficiency.
affected
Affects developers using Container API with getContainerRenderer() imports from package root.
action
Update imports to use the new container-renderer entrypoint as shown in the diff snippet.
release_signals
!Importing getContainerRenderer() from package root is now deprecated and will log a warning
+Added container-renderer entrypoint for getContainerRenderer() across multiple integrations (React, Preact, Svelte, SolidJS, Vue, MDX)
migration_steps2 steps
- 01Update getContainerRenderer() imports to use '@astrojs/react/container-renderer' instead of package root
- 02For React, change: import { getContainerRenderer } from '@astrojs/react' to import { getContainerRenderer } from '@astrojs/react/container-renderer'
astro@7.0.0-beta.5highbreakingmigrationfeatureprereleaseJun 18, 2026
astro@7.0.0-beta.5
This release introduces a major change in HTML compression behavior, making 'jsx' the default for `compressHTML`, which may affect rendered output. Several bug fixes and performance improvements are also included.
affected
Developers relying on the previous default HTML compression behavior may see changes in rendered output.
action
Review and adjust `compressHTML` settings if necessary to maintain desired whitespace behavior.
release_signals
-The default `compressHTML` behavior now uses JSX rules, which removes whitespace around elements but preserves meaningful whitespace within a line. This may change rendered output where whitespace between inline elements was previously meaningful.
+Makes 'jsx' the default value for `compressHTML`, changing how whitespace is handled in HTML output.
migration_steps1 steps
- 01To keep Astro's earlier behavior, set `compressHTML: true` for HTML-aware compression, or `compressHTML: false` to preserve all whitespace.