Ver como Markdown
Abrir en ChatGPTAbrir en Claude
ES
empezar

Introducción

Qué es astro-ignite, por qué existe y qué obtienes de fábrica.

Last updated

astro-ignite es un CLI estilo shadcn para crear sitios Astro listos para producción hechos para agentes de IA. Obtienes un sitio completo con SEO, i18n, rendimiento, plantillas legales y email ya cableados.

Por qué molestarse

La mayoría de los starters de Astro se quedan en uno de dos extremos: un hola mundo mínimo que tienes que ensamblar tú, o un framework opinado que esconde las decisiones tras abstracciones. astro-ignite elige otro punto — valores opinados que el desarrollador posee por completo.

Obtienes:

  • Lighthouse 100 en móvil desde el primer momento, verificado por CI
  • i18n nativo con un único camino de código para sitios mono y multilingües
  • JSON-LD de Schema.org tipado generado con schema-dts
  • Un formulario de contacto funcional con Astro Actions, Zod y Resend o SMTP
  • Banner de cookies + plantillas legales que no fingen ser asesoría legal
  • Geist Sans + Mono autoalojados sin CLS al cambiar
  • Componentes Astro puros — sin runtime de React/Vue/Svelte cargando la página

Arquitectura

  • CLI estilo shadcn, no un framework. create-astro-ignite es un scaffolder de un solo uso. Una vez instalado, desaparece de tu node_modules — sin imports, sin plugin, sin auto-update, sin telemetría.
  • Tres responsabilidades, tres paquetes. El CLI vive en packages/create-astro-ignite/. Los proyectos Astro reales viven en packages/templates/<kind>/ (starter, docs, …). Un registro de componentes estilo shadcn vive en packages/registry/. El CLI ensambla una plantilla; los átomos del registro vienen pre-instalados.
  • Las apps son salidas canónicas del scaffolding. apps/site y apps/docs son espejos generados desde las plantillas, no fuentes.

Stack técnico

  • Astro 6 con i18n nativo, content collections y Astro Actions (adaptador @astrojs/node@^10)
  • Tailwind v4 con utilidades que resuelven los design tokens --color-*; <style> con scope solo donde Tailwind no llega (keyframes, selectores de view-transition); inlineStylesheets: 'always' incrusta la hoja de estilos completa en el HTML en el primer paint — sin paso aparte de CSS crítico
  • Variables CSS como design tokens; modo oscuro tri-estado mediante un cambio de clase
  • Astro + JS vanilla en todos los componentes — sin React/Vue/Svelte/Radix en ninguna parte. Primitivas HTML nativas primero (<details>, <dialog>, popover API); custom elements solo cuando lo nativo no alcanza
  • schema-dts para JSON-LD tipado compuesto vía @graph
  • Astro Actions + Zod + Resend o SMTP para el formulario de contacto
  • Plausible, gated por env y consentimiento; Geist Sans + Mono autoalojados
  • [email protected] workspaces, tsup para el CLI, vitest, changesets, Lighthouse CI (móvil + escritorio, gate duro)

Lo que NO es

astro-ignite no es un framework. El paquete astro-ignite en npm es un CLI para crear y mantener tu proyecto — nunca acaba siendo una dependencia en runtime del sitio generado. Tras el scaffolding eres dueño de cada línea y puedes editar lo que quieras. El “eject” es gratis porque no hay nada de lo que escapar.

Tampoco es un CMS, un sistema de autenticación, ni un starter de e-commerce. Es un bootstrap de sitio.

A dónde ir ahora

Para un recorrido por lo que obtienes de fábrica, dirígete a Características. Si quieres ver código, salta directo a Inicio rápido.