morphos

Morphous는 TanStack Start로 구축된 자연 영감 디자인 시스템용 정적 카탈로그입니다. 각 카탈로그 항목은 동물, 식물, 광물, 날씨, 풍경을 모티프로 시작하며, 투명한 모티프 자산, light/dark 디자인 시스템 보드, 기록된 프롬프트, shadcn/tweakcn 스타일 CSS 변수와 호환되는 테마 내보내기를 포함합니다. 프로젝트는 패키지 관리 및 스크립트에 Bun을 사용하며, TanStack Start, Vite, React, Tailwind CSS를 활용합니다. .output/public에서 정적 프리렌더링 출력을 생성하고 GitHub Actions를 통해 GitHub Pages에 배포합니다. 출판 사이트는 morphos.ameyanagi.com에 구성됩니다. 카탈로그 번들은 public/systems/{slug}/ 아래에 있으며, 일반적으로 prompts.json, system.json, theme.css, theme.json, motif.png, design-system-light.png, design-system-dark.png를 포함합니다. 이전 번들은 system.json에 기록된 animal.png 또는 design-system.png와 같은 동등한 자산 이름을 사용할 수 있습니다. 카탈로그 UI는 public 번들 파일을 읽고 각 시스템 디렉터리에서 프롬프트와 테마 내보내기를 노출합니다. 개발 명령어로는 로컬 개발 서버 실행용 bun run dev, 린트 및 타입체크용 bun run check, 테스트용 bun run test, 린트/타입체크/테스트/프로덕션 빌드 전담 bun run ci가 있습니다. bun run generate:previews는 갤러리 렌더링을 위한 가벼운 WebP 미리보기 파생물을 생성합니다. bun run pages:prepare는 정적 빌드 출력을 검증하고 GitHub Pages 배포 파일을 추가합니다. 카탈로그 새로고침 및 검증은 bun run generate:catalog, bun run generate:previews, bun run validate:catalog를 사용합니다. 자산 생성은 .codex/skills/morphous-catalog/SKILL.md에 있는 프로젝트 전용 Codex 스킬이 담당합니다. 이미지 생성은 Codex 이미지 도구로 수행된 후 각 시스템 번들에 복사됩니다. bun install 실행 중 설치되는 Husky pre-commit 훅은 generate:previews 및 check를 실행합니다. GitHub Pages 배포는 main 브랜치로의 푸시를 통해 실행되며 수동으로 시작할 수 있습니다. 워크플로는 Bun으로 의존성을 설치하고, CI를 실행한 다음, .output/public을 Pages 아티팩트로 업로드하며 actions/deploy-pages로 배포합니다. Public CNAME 및 .nojekyll 파일은 커스텀 도메인과 정확한 자산 서비스를 지원합니다. 풀 리퀘스트는 배포 없이 CI를 실행합니다. 이 프로젝트는 Apache-2.0 또는 MIT 라이선스로 이중 라이선스됩니다.