منصوبے کے بارے میں

Sparkle کو جدید ویب، موبائل، اور WASM ڈویلپمنٹ پیٹرنز کی تلاش کے لیے ایک TypeScript پلے گراؤنڈ monorepo کے طور پر بیان کیا گیا ہے۔ README میں ذکر ہے کہ یہ تجرباتی ہے اور اس کے APIs اور آرکیٹیکچر تیزی سے تبدیل ہو رہے ہیں۔ یہ ورک اسپیس Turborepo اور pnpm استعمال کرتا ہے، جس کے لیے Node.js >=22.13.1 اور pnpm >=10 درکار ہے۔ کلوننگ کے بعد، pnpm bootstrap ڈیپینڈنسیز انسٹال کرتا ہے اور pnpm dev مکمل ڈویلپمنٹ ماحول شروع کرتا ہے۔ بنیادی پیکیجز میں @sparkle/ui شامل ہے، جو Radix UI primitives اور Tailwind CSS پر مبنی ایک قابل رسائی React کمپوننٹ لائبریری ہے؛ @sparkle/theme، ویب اور نیٹو کے لیے کراس پلیٹ فارم ڈیزائن ٹوکنز اور تھیم پرووائیڈرز؛ @sparkle/types، مشترکہ TypeScript ٹائپ تعریفیں؛ اور @sparkle/utils، یوٹیلیٹی فنکشنز اور React hooks۔ ایپلی کیشنز اور معاون ورک اسپیسز میں apps/fro-jive، ایک Expo / React Native موبائل ایپ؛ apps/moo-dang، Zig-compiled ایگزیکیوٹیبلز اور xterm.js کے ساتھ ایک WASM-powered ویب شیل؛ packages/storybook کمپوننٹ دستاویزات، پلے گراؤنڈ، اور بصری ٹیسٹ کے لیے؛ اور docs/، ایک Astro Starlight ڈاکومنٹیشن سائٹ شامل ہیں۔ ڈویلپمنٹ ٹولنگ میں مشترکہ بلڈ، لنٹ، اور Tailwind کنفیگریشنز کے لیے @sparkle/config؛ فیکٹری-بیسڈ موکس کے لیے @sparkle/test-utils؛ اور فلوئنٹ ایرر-سیناریو ٹیسٹنگ کے لیے @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 شامل ہیں۔ ریپوزٹری Deciduous کے ذریعے ایک git-native فیصلے کے گراف میں آرکیٹیکچرل فیصلوں کو بھی ٹریک کرتی ہے۔ صرف .deciduous/config.toml اور .deciduous/sync/ کو کمٹ کیا جاتا ہے؛ SQLite کیش، narratives.md، اور documents/ کو gitignore کیا گیا ہے۔ README .deciduous/sync/** کے لیے ایک کسٹم مرج ڈرائیور بیان کرتا ہے اور نوٹ کرتا ہے کہ دستی تنازعہ حل کرنے کی ضرورت پڑ سکتی ہے، اور اگر deciduous CLI PATH پر نہ ہو تو مرج ناکام ہو سکتا ہے۔ README ایک ڈاکومنٹیشن سائٹ، Storybook، copilot ہدایات، اور Changesets ورک فلو کے لنکس فراہم کرتا ہے۔ یہ MIT لائسنس کے تحت ہے۔