morphos

Morphous es un catálogo estático construido con TanStack Start para sistemas de diseño inspirados en la naturaleza. Cada entrada del catálogo comienza con un motivo animal, vegetal, mineral, meteorológico o de paisaje e incluye un activo transparente del motivo, tableros de sistema de diseño en modo claro y oscuro, prompts grabados y exportaciones de temas compatibles con variables CSS estilo shadcn/tweakcn. El proyecto utiliza Bun para la gestión de paquetes y scripts, además de TanStack Start, Vite, React y Tailwind CSS. Produce una salida estática prerrenderizada bajo .output/public y se implementa en GitHub Pages a través de GitHub Actions. El sitio publicado está configurado para morphos.ameyanagi.com. Los paquetes del catálogo residen bajo public/systems/{slug}/ y típicamente contienen prompts.json, system.json, theme.css, theme.json, motif.png, design-system-light.png y design-system-dark.png. Los paquetes más antiguos pueden usar nombres de activos equivalentes registrados en system.json, como animal.png o design-system.png. La interfaz del catálogo lee los archivos públicos del paquete y expone los prompts y las exportaciones de tema de cada directorio del sistema. Los comandos de desarrollo incluyen bun run dev para el servidor de desarrollo local, bun run check para lint y typecheck, bun run test para pruebas, y bun run ci para lint, typecheck, pruebas y compilación de producción. bun run generate:previews crea derivados ligeros WebP para renderizado en galería. bun run pages:prepare valida la salida de compilación estática y añade archivos de implementación de GitHub Pages. La actualización y validación del catálogo utilizan bun run generate:catalog, bun run generate:previews y bun run validate:catalog. La generación de activos es manejada por una skill Codex específica del proyecto en .codex/skills/morphous-catalog/SKILL.md. La generación de imágenes se realiza con la herramienta de imagen de Codex, luego se copia en cada paquete del sistema. Un hook pre-commit de Husky instalado durante bun install ejecuta generate:previews y check. La implementación en GitHub Pages se ejecuta en pushes a main y puede iniciarse manualmente; el workflow instala dependencias con Bun, ejecuta CI, sube .output/public como artefacto de Pages e implementa con actions/deploy-pages. Los archivos públicos CNAME y .nojekyll soportan el dominio personalizado y el servicio exacto de activos. Las pull requests ejecutan CI sin desplegar. El proyecto está licenciado doblemente bajo Apache-2.0 o MIT.