عن المشروع

يتم وصف Sparkle على أنه monorepo تجريبي بلغة TypeScript لاستكشاف أنماط تطوير الويب والهاتف المحمول وWASM الحديثة. يشير ملف README إلى أنه تجريبي وأن واجهات برمجة التطبيقات (APIs) وبنيته تتطور بشكل متسارع. تستخدم مساحة العمل Turborepo و pnpm، وتتطلب Node.js >=22.13.1 و pnpm >=10. بعد عملية الاستنساخ (cloning)، يقوم الأمر pnpm bootstrap بتثبيت التبعيات، بينما يبدأ pnpm dev بيئة التطوير الكاملة. تشمل الحزم الأساسية @sparkle/ui، وهي مكتبة مكونات React سهلة الوصول مبنية على أساسيات Radix UI و Tailwind CSS؛ و @sparkle/theme، التي توفر رموز التصميم (design tokens) ومزودي السمات عابري المنصات للويب والتطبيقات الأصلية؛ و @sparkle/types، لتعريفات أنواع TypeScript المشتركة؛ و @sparkle/utils، لوظائف المساعدة وReact hooks. تتضمن التطبيقات ومساحات العمل الداعمة apps/fro-jive، وهو تطبيق موبايل Expo / React Native؛ و apps/moo-dang، وهي واجهة ويب تعمل بـ WASM مع ملفات تنفيذية مجمعة بلغة Zig و xterm.js؛ و packages/storybook لتوثيق المكونات والبيئة التجريبية والاختبارات المرئية؛ و docs/، وهو موقع توثيق Astro Starlight. تشمل أدوات التطوير @sparkle/config لإعدادات البناء والتدقيق (lint) وTailwind المشتركة؛ و @sparkle/test-utils للمحاكاة القائمة على المصانع (factory-based mocks)؛ و @sparkle/error-testing لاختبار سيناريوهات الأخطاء الانسيابية. كما تدرج الحزمة التقنية كلاً من Vite و tsdown و Vitest و Playwright للتراجع المرئي، و Testing Library و ESLint و Prettier. تشمل الأوامر الشائعة pnpm bootstrap و pnpm dev و pnpm build و pnpm test و pnpm check و pnpm fix و pnpm health-check و pnpm clean. وتظهر أمثلة تصفية مساحة العمل أوامر مثل pnpm add --filter @sparkle/ui react و pnpm --filter @sparkle/ui build و pnpm -r build. أما أوامر التوثيق فتشمل pnpm --filter @sparkle/docs dev و build و docs:automation. يتتبع المستودع أيضاً القرارات المعمارية في رسم بياني للقرارات مدمج في git عبر Deciduous. يتم فقط تثبيت .deciduous/config.toml و .deciduous/sync/؛ بينما يتم تجاهل ذاكرة التخزين المؤقت SQLite و narratives.md و documents/ عبر gitignore. يصف ملف README برنامج تشغيل دمج مخصص لـ .deciduous/sync/** ويشير إلى أن حل التعارضات يدوياً قد يكون مطلوباً، مع احتمال فشل الدمج إذا لم يكن deciduous CLI موجوداً في PATH. يربط ملف README بموقع التوثيق، وStorybook، وتعليمات copilot، وسير عمل Changesets. المشروع مرخص بموجب رخصة MIT.