Sobre o projeto

O Sparkle é descrito como um monorepo de playground TypeScript para explorar padrões modernos de desenvolvimento web, mobile e WASM. O README observa que é experimental e que suas APIs e arquitetura evoluem agressivamente. O workspace utiliza Turborepo e pnpm, exigindo Node.js >=22.13.1 e pnpm >=10. Após a clonagem, pnpm bootstrap instala as dependências e pnpm dev inicia o ambiente completo de desenvolvimento. Os pacotes principais incluem @sparkle/ui, uma biblioteca de componentes React acessível construída sobre primitivos Radix UI e Tailwind CSS; @sparkle/theme, tokens de design multiplataforma e provedores de tema para web e native; @sparkle/types, definições de tipos TypeScript compartilhadas; e @sparkle/utils, funções utilitárias e hooks React. As aplicações e workspaces de suporte incluem apps/fro-jive, um app mobile Expo / React Native; apps/moo-dang, um shell web alimentado por WASM com executáveis compilados em Zig e xterm.js; packages/storybook para documentação de componentes, playground e testes visuais; e docs/, um site de documentação Astro Starlight. As ferramentas de desenvolvimento incluem @sparkle/config para configurações compartilhadas de build, lint e Tailwind; @sparkle/test-utils para mocks baseados em factory; e @sparkle/error-testing para testes fluentes de cenários de erro. A stack também lista Vite, tsdown, Vitest, Playwright para regressão visual, Testing Library, ESLint e Prettier. Comandos comuns incluem pnpm bootstrap, pnpm dev, pnpm build, pnpm test, pnpm check, pnpm fix, pnpm health-check e pnpm clean. Exemplos de filtragem de workspace mostram pnpm add --filter @sparkle/ui react, pnpm --filter @sparkle/ui build e pnpm -r build. Comandos de documentação incluem pnpm --filter @sparkle/docs dev, build e docs:automation. O repositório também rastreia decisões arquiteturais em um grafo de decisão nativo do git via Deciduous. Apenas .deciduous/config.toml e .deciduous/sync/ são commitados; o cache SQLite, narratives.md e documents/ são ignorados pelo git. O README descreve um driver de merge customizado para .deciduous/sync/** e observa que a resolução manual de conflitos ainda pode ser necessária, além de possível falha no merge se a CLI deciduous não estiver no PATH. O README contém links para um site de documentação, Storybook, instruções do copilot e um fluxo de trabalho de Changesets. Possui licença MIT.