Astro

Overview

Implement production-ready Astro work with docs-first defaults and minimal guesswork. Start with the general workflow, then use the blog-focused section when the task is specifically a blog or content site.

Read references/astro-playbook.md for current versions, commands, API patterns, and blog-specific implementation details.

General Workflow

1. Confirm runtime and rendering model.

• Identify whether the task is static-first, mixed mode, or server-first.
• If on-demand rendering is required, ensure an adapter is installed and routes opt out of prerendering (or use server output mode).

2. Set up or normalize project baseline.

• Use create astro@latest for new projects.
• Keep astro.config.* explicit (site, integrations, output mode as needed).
• Prefer astro add for official integrations.