sparkle

Sparkle is described as a TypeScript playground monorepo for exploring modern web, mobile, and WASM development patterns. The README notes that it is experimental and that its APIs and architecture evolve aggressively. The workspace uses Turborepo and pnpm, requiring Node.js >=22.13.1 and pnpm >=10. After cloning, pnpm bootstrap installs dependencies and pnpm dev starts the full development environment. Core packages include @sparkle/ui, an accessible React component library built on Radix UI primitives and Tailwind CSS; @sparkle/theme, cross-platform design tokens and theme providers for web and native; @sparkle/types, shared TypeScript type definitions; and @sparkle/utils, utility functions and React hooks. Applications and supporting workspaces include apps/fro-jive, an Expo / React Native mobile app; apps/moo-dang, a WASM-powered web shell with Zig-compiled executables and xterm.js; packages/storybook for component docs, playground, and visual tests; and docs/, an Astro Starlight documentation site. Development tooling includes @sparkle/config for shared build, lint, and Tailwind configurations; @sparkle/test-utils for factory-based mocks; and @sparkle/error-testing for fluent error-scenario testing. The stack also lists Vite, tsdown, Vitest, Playwright for visual regression, Testing Library, ESLint, and Prettier. Common commands include pnpm bootstrap, pnpm dev, pnpm build, pnpm test, pnpm check, pnpm fix, pnpm health-check, and pnpm clean. Workspace filtering examples show pnpm add --filter @sparkle/ui react, pnpm --filter @sparkle/ui build, and pnpm -r build. Documentation commands include pnpm --filter @sparkle/docs dev, build, and docs:automation. The repository also tracks architectural decisions in a git-native decision graph via Deciduous. Only .deciduous/config.toml and .deciduous/sync/ are committed; the SQLite cache, narratives.md, and documents/ are gitignored. The README describes a custom merge driver for .deciduous/sync/** and notes manual conflict resolution may still be needed, plus possible merge failure if the deciduous CLI is not on PATH. The README links to a documentation site, Storybook, copilot instructions, and a Changesets workflow. It is MIT licensed.