morphos

Morphous est un catalogue statique construit avec TanStack Start pour des systèmes de design inspirés de la nature. Chaque entrée de catalogue commence par un motif animal, végétal, minéral, météorologique ou paysager et comprend un actif de motif transparent, des interfaces de système de design clair et sombre, des invites enregistrées et des exports de thèmes compatibles avec les variables CSS style shadcn/tweakcn. Le projet utilise Bun pour la gestion des packages et des scripts, ainsi que TanStack Start, Vite, React et Tailwind CSS. Il produit une sortie statique pré-rendue sous .output/public et se déploie sur GitHub Pages via GitHub Actions. Le site publié est configuré pour morphos.ameyanagi.com. Les bundles de catalogue résident dans public/systems/{slug}/ et contiennent généralement prompts.json, system.json, theme.css, theme.json, motif.png, design-system-light.png et design-system-dark.png. Les bundles plus anciens peuvent utiliser des noms d'actifs équivalents enregistrés dans system.json, tels que animal.png ou design-system.png. L'interface du catalogue lit les fichiers bundle publics et expose les invites et exports de thème de chaque répertoire système. Les commandes de développement incluent bun run dev pour le serveur de développement local, bun run check pour le linter et le typecheck, bun run test pour les tests, et bun run ci pour le linter, le typecheck, les tests et la build de production. bun run generate:previews crée des dérivés WebP d'aperçu légers pour le rendu de galerie. bun run pages:prepare valide la sortie de build statique et ajoute les fichiers de déploiement GitHub Pages. Le rafraîchissement et la validation du catalogue utilisent bun run generate:catalog, bun run generate:previews et bun run validate:catalog. La génération d'actifs est gérée par une compétence Codex spécifique au projet située dans .codex/skills/morphous-catalog/SKILL.md. La génération d'images est effectuée avec l'outil image de Codex, puis copiée dans chaque bundle de système. Un hook pre-commit Husky installé pendant bun install exécute generate:previews et check. Le déploiement GitHub Pages s'exécute sur les pushes vers main et peut être lancé manuellement ; le workflow installe les dépendances avec Bun, exécute CI, télécharge .output/public comme artefact Pages, et déploie avec actions/deploy-pages. Les fichiers CNAME et .nojekyll publics prennent en charge le domaine personnalisé et le service d'actifs exact. Les pull requests exécutent CI sans déployer. Le projet est doublement licencié sous Apache-2.0 ou MIT.