#astro

A terminal window showing the real Node.js error: Cannot find module satteri, reproduced under pnpm's default isolated node_modules linker

Fix Astro 7 Cannot Find Package satteri Error (pnpm)

Fix Astro 7's Cannot find package satteri error under pnpm. Still open upstream, with a live-tested workaround using node-linker=hoisted.

Aug 5, 2026Read more →

A terminal window showing the real Astro warning: markdown.gfm and markdown.smartypants are deprecated, printed by the Container API even though the project never set either option

Guides & Fixes

Fix Astro 7's False markdown.gfm Deprecation Warning

Fix Astro 7's false markdown.gfm and markdown.smartypants deprecation warning from the Container API, and the version that fixes it.

Aug 5, 2026Read more →

A terminal window showing the real Vite build error: MISSING_EXPORT satteriCollectImagesPlugin is not exported by the @astrojs/markdown-satteri optional peer dependency

Guides & Fixes

Fix Astro 7 MISSING_EXPORT satteriCollectImagesPlugin

Fix Astro 7's MISSING_EXPORT satteriCollectImagesPlugin error from @astrojs/mdx. The real cause, and the version that already fixes it.

Aug 5, 2026Read more →

A terminal window showing the real Astro build warning: markdown.remarkPlugins, markdown.rehypePlugins, and markdown.remarkRehype are deprecated, pass them to unified from at astrojs slash markdown-remark directly instead

Guides & Fixes

Fix Astro 7 markdown.rehypePlugins Deprecation Warning

Fix Astro 7's markdown.rehypePlugins deprecation warning. The exact config fix, tested live against a real Astro 7 build.

Aug 5, 2026Read more →

A terminal window showing the real Vite/Rollup warning: Rollup failed to resolve import satteri from the @astrojs/mdx dist folder, most likely unintended because it can break your application at runtime

Guides & Fixes

Fix Astro 7 Rollup Failed to Resolve Import satteri

Fix Astro 7's Rollup failed to resolve import satteri error from getContainerRenderer. Real cause, and the exact @astrojs/mdx version already fixing it.

Aug 5, 2026Read more →

A code diff showing the fix for Astro 7's Satteri heading-ids plugin: collecting headings into a local array and assigning it once, instead of pushing directly onto the shared astro.headings array

Guides & Fixes

Fix Astro 7 Duplicate Heading IDs From Sätteri Bug

Fix Astro 7 Satteri duplicate heading entries when Starlight assigns its own IDs first. Confirmed fixed in this site's own installed version.

Aug 5, 2026Read more →

A terminal window showing the real error: Not implemented, thrown from PluginContextImpl.generateBundle when Astro's dev toolbar runs under Vite 8's Rolldown esbuild-compat shim

Guides & Fixes

Fix Astro Dev Toolbar 'Not Implemented' Crash

Fix Astro's dev toolbar crashing with a 'Not implemented' error under Vite 8's Rolldown esbuild-compat shim. Real workaround included.

Aug 5, 2026Read more →

A terminal window showing the real astro-mermaid warning: markdown.remarkPlugins, rehypePlugins, and remarkRehype are set, but your satteri processor doesn't run them

Guides & Fixes

Fix astro-mermaid Diagrams Breaking Under Astro 7

Fix astro-mermaid diagrams silently rendering as plain code under Astro 7's Satteri processor, and the version that fixes it.

Aug 5, 2026Read more →

The same strong and span markup rendered under two Astro versions: Astro 6 shows 'Save 20%' with the space intact, Astro 7 shows 'Save20%' with the space collapsed by the new compressHTML default

Guides & Fixes

Fix Astro 7 compressHTML Spacing Bug After Upgrade

Astro 7 changes compressHTML's default, collapsing space between inline elements on separate lines. Here's why, and the two ways to fix it.

Aug 4, 2026Read more →

A terminal window showing Astro's real InvalidContentEntryDataError output for an invalid category value, with the exact field and reason it prints

Guides & Fixes

Fix Astro InvalidContentEntryDataError Schema Errors

InvalidContentEntryDataError means a post's frontmatter doesn't match its schema. Here's how to read the message and fix the four most common causes.

Aug 4, 2026Read more →

A terminal window showing the wrangler.toml assets configuration with not_found_handling set to 404-page, the setting that makes Cloudflare Workers serve a real custom 404 page

Guides & Fixes

Fix Cloudflare Workers Empty 404 Page on Static Sites

Cloudflare Workers Static Assets doesn't serve your custom 404.html by default. Here's the exact config that fixes it, confirmed on a live production site.

Aug 4, 2026Read more →

A terminal window showing a real npm ERESOLVE error after upgrading to Astro 7: npm cannot resolve vite@8.2.0 against a plugin's peer dependency capped at Vite 7

Guides & Fixes

Fix ERESOLVE Vite 8 Peer Dependency Errors in Astro 7

Fix the ERESOLVE peer dependency error when npm install fails after upgrading to Astro 7, caused by plugins that don't yet support Vite 8.

Aug 4, 2026Read more →

Side-by-side code comparison: broken Astro markup with {count} and {label} on separate lines rendering as '5posts', next to the fixed version with an explicit {" "} rendering correctly as '5 posts'

Guides & Fixes

Why Astro Silently Merges Text Like '5posts' Into One Word

Astro silently collapses whitespace between two expressions on separate lines, merging {count} and {label} into '5posts'. Here's the one-character fix.

Jul 30, 2026Read more →

Close-up of colorful syntax-highlighted code on a screen, representing debugging structured data

Guides & Fixes

Fixing 'Missing Field Author' in Google's Rich Results Test

Why Google's Rich Results Test flags a missing author field on Article pages, and how to add correct Person and Organization JSON-LD in Astro to resolve it.

Jul 27, 2026Read more →