Astro + Starlight Best Practices

Use this skill for apps/eridu_docs and other Astro/Starlight doc surfaces.

Workflow

1. Classify the change:
   • docs content + sidebar
   • Astro route/endpoint
   • SSR/auth middleware behavior
   • search/index behavior
   • Starlight UI override
2. Pick the lowest-complexity rendering model that satisfies requirements.
3. Keep content/schema/search decisions aligned with Starlight defaults unless there is a strong requirement to diverge.
4. Verify the app with repo-standard commands before finalizing.

Guardrails

1) Rendering mode and prerender