Astro

Astro’s troubleshooting page functions as a known-issues file. It covers SSR/SSG gotchas, content-collection edge cases, integration-specific quirks, and the build-pipeline behavior that surprises teams coming from Next.js or SvelteKit.

The node:fs/promises-can’t-be-bundled-in-Worker-builds issue that broke this site’s deploy is documented here, with the standard fix of using import.meta.glob() for build-time file reads. Reading the page once before starting a new Astro project saves several specific debugging sessions.

The page is updated by the Astro core team and the community as new edge cases surface.