इस प्रोजेक्ट के बारे में

Sparkle को आधुनिक वेब, मोबाइल और WASM डेवलपमेंट पैटर्न की खोज के लिए एक TypeScript playground monorepo के रूप में वर्णित किया गया है। README में उल्लेख है कि यह प्रयोगात्मक है और इसके APIs और आर्किटेक्चर तेजी से विकसित हो रहे हैं। यह वर्कस्पेस Turborepo और pnpm का उपयोग करता है, जिसके लिए Node.js >=22.13.1 और pnpm >=10 की आवश्यकता होती है। क्लोनिंग के बाद, pnpm bootstrap डिपेंडेंसी इंस्टॉल करता है और pnpm dev पूर्ण डेवलपमेंट एनवायरनमेंट शुरू करता है। मुख्य पैकेजों में @sparkle/ui शामिल है, जो Radix UI primitives और Tailwind CSS पर आधारित एक accessible React component library है; @sparkle/theme, वेब और नेटिव के लिए cross-platform design tokens और theme providers; @sparkle/types, साझा TypeScript type definitions; और @sparkle/utils, यूटिलिटी फंक्शन्स और React hooks हैं। एप्लीकेशन्स और सपोर्टिंग वर्कस्पेस में apps/fro-jive, एक Expo / React Native मोबाइल ऐप; apps/moo-dang, Zig-compiled executables और 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 decision graph में आर्किटेक्चरल निर्णयों को भी ट्रैक करती है। केवल .deciduous/config.toml और .deciduous/sync/ कमिट किए जाते हैं; SQLite कैश, narratives.md और documents/ को gitignore किया गया है। README .deciduous/sync/** के लिए एक कस्टम मर्ज ड्राइवर का वर्णन करता है और नोट करता है कि मैनुअल कॉन्फ्लिक्ट रिज़ॉल्यूशन की आवश्यकता हो सकती है, साथ ही यदि deciduous CLI PATH पर नहीं है तो मर्ज विफल हो सकता है। README एक डॉक्यूमेंटेशन साइट, Storybook, copilot निर्देशों और Changesets वर्कफ़्लो के लिंक प्रदान करता है। यह MIT लाइसेंस के तहत है।