← Todas las plantillas

Estático por defecto, islas solo donde hacen falta, cero JavaScript en las páginas de contenido.

Constitution — Astro content site

Version 1.0.0 · Ratified 2026-11-10

These principles hold for every spec, plan and task of the project. A spec may add rules; it never weakens these.

  1. Static by default. Pages are prerendered at build time. A route rendered on demand (export const prerender = false) needs a reason in the plan, such as per-request data.

  2. Islands only where needed. A component gets a client:* directive only when it is interactive, and the plan says why. client:visible or client:idle is preferred; client:load needs a reason.

  3. Zero JavaScript on content pages. Articles, docs and landing content ship no <script> at all. A CI check over dist/ fails the build when a content page loads JavaScript.

  4. Typed content collections. Content lives in collections with a zod schema in src/content.config.ts. Invalid frontmatter fails the build instead of rendering a broken page.

  5. Fast and accessible. Images use <Image /> from astro:assets with alt text, and Lighthouse scores at least 95 for performance and accessibility on every template. LCP stays under 2.5 s on mobile.