MenúChevron Down
Introducción - Docs - Artefact

Introducción

Este es un starter full-stack construido sobre HonoX, que combina un sistema de estilos tipado con un CMS respaldado por Git, y entrega todo el conjunto como un sitio estático. Está pensado como base con todo incluido para sitios orientados a contenido —— documentación, blogs, páginas de marketing —— que aun así quieren componentes realmente interactivos donde importa.

Pieza Qué hace
HonoX Meta-framework sobre Hono —— enrutamiento basado en archivos, islas servidor/cliente
PandaCSS CSS-in-JS tipado y sin runtime, compilado por adelantado
Sveltia CMS Edición de contenido respaldada por Git en /admin/ —— sin base de datos, sin servicio backend
@hono/vite-ssg Pre-renderiza cada ruta a HTML estático en tiempo de build

Por qué este stack

  • Estático por defecto. El resultado del build es HTML/CSS/JS plano —— no se requiere ningún proceso de servidor en tiempo de petición, así que se despliega en cualquier lugar donde se sirvan archivos estáticos (Cloudflare Pages y Vercel ya vienen configurados).
  • Interactivo donde importa. No todos los componentes necesitan enviar JavaScript. Un modelo de hidratación de tres niveles permite que cada componente decida si se hidrata de forma inmediata, condicional, o nunca —— manteniendo el bundle del cliente pequeño sin renunciar a una UI rica.
  • Contenido editable sin tocar código. Sveltia CMS se ejecuta enteramente en el cliente y hace commit directamente sobre los archivos bajo content/, de modo que los editores pueden escribir entradas de blog, documentación, e incluso componer páginas enteras visualmente mediante el Constructor de Páginas, mientras que los desarrolladores mantienen todo bajo control de versiones.
  • Estilos con confianza. PandaCSS genera todo el CSS por adelantado a partir de llamadas de estilo analizables estáticamente —— sin motor de estilos en runtime, sin colisiones de nombres de clase, y con seguridad de tipos completa en los design tokens.

Qué incluye

  • Cerca de 50 componentes de UI bajo app/components/ui/, cubriendo layout, formularios, overlays y presentación de datos, cada uno con su contraparte interactiva en app/islands/ cuando es necesario.
  • Un blog (content/posts/) con etiquetas, páginas de autor y una API JSON de solo lectura.
  • Un constructor de páginas visual (content/pages/) para componer páginas a partir de componentes anidados enteramente desde el CMS.
  • Documentación (esta sección), escrita en Markdown plano o MDX, este último para páginas que necesitan un ejemplo renderizado en vivo incrustado en el texto.
  • i18n en seis idiomas (en, zh, es, pt, fr, de) para la documentación, los componentes y la interfaz del sitio.

Por dónde seguir

  • Primeros Pasos —— instala las dependencias y ejecuta el proyecto en local.
  • Arquitectura —— una mirada más profunda al build, el enrutamiento, la estructura de componentes y los pipelines de contenido.
  • Hidratación —— cómo los componentes optan por la interactividad del lado del cliente.
  • Constructor de Páginas CMS —— composición visual de páginas a través de Sveltia CMS.