عن المشروع

Morphous هو كتالوج ثابت مُبنى باستخدام TanStack Start لأنظمة التصميم المستوحاة من الطبيعة. يبدأ كل إدخال في الكتالوج بنموذج حيواني أو نباتي أو معدني أو جوي أو أرضي، ويتضمن أصل الشعار بشكل شفاف، ولوحات نظام تصميم للفاتح والداكن، وموجهات مسجلة، وتصديرات سمات متوافقة مع متغيرات CSS بأسلوب shadcn/tweakcn. يستخدم المشروع Bun لإدارة الحزم والنصوص البرمجية، بالإضافة إلى TanStack Start وVite وReact وTailwind CSS. ينتج مخرجًا ثابتًا مُجهزًا مسبقًا تحت .output/public وينتقل إلى GitHub Pages عبر GitHub Actions. الموقع المنشور مضبوط ليكون على 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. تقرأ واجهة الكتالوج ملفات الحزم العمومية وتعرض الموجهات وتصديرات السمات من كل دليل نظام. تشمل أوامر التطوير: 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 خاصة بالمشروع موجودة في .codex/skills/morphous-catalog/SKILL.md. يُنفَّذ توليد الصور بأداة Codex للصورة، ثم يُنسخ إلى كل حزمة نظام. يعمل خط إعداد Husky قبل_COMMIT الذي يُثبَّت أثناء bun install على تشغيل generate:previews وcheck. يعمل نشر GitHub Pages عند الدفع إلى main ويمكن بدءُه يدويًا؛ حيث يُركِّب العمل التبعيات عبر Bun، ويشغّل CI، ويرفع .output/public كنتاج لصفحات GitHub، وينشر باستخدام actions/deploy-pages. تدعم ملفات CNAME و.nojekyll العمومية النطاق المخصص وتقديم الأصول بدقة. تُشغَّل الاختبارات CI على طلبات السحب دون نشر. المشروع مرخّص مزدوجًا تحت Apache-2.0 أو MIT.