Об этом проекте

Sparkle представляет собой TypeScript playground monorepo для изучения современных паттернов веб-, мобильной и WASM-разработки. В README указано, что проект является экспериментальным, а его API и архитектура активно развиваются. Рабочее пространство использует Turborepo и pnpm, требуя Node.js >=22.13.1 и pnpm >=10. После клонирования команда pnpm bootstrap устанавливает зависимости, а pnpm dev запускает полную среду разработки. Основные пакеты включают: @sparkle/ui — доступная библиотека React-компонентов на базе примитивов Radix UI и Tailwind CSS; @sparkle/theme — кроссплатформенные дизайн-токены и провайдеры тем для веба и native; @sparkle/types — общие определения типов TypeScript; и @sparkle/utils — утилиты и React-хуки. Приложения и вспомогательные рабочие пространства включают: apps/fro-jive — мобильное приложение на Expo / React Native; apps/moo-dang — веб-оболочка на базе WASM с исполняемыми файлами, скомпилированными на Zig, и xterm.js; packages/storybook для документации компонентов, песочницы и визуальных тестов; и docs/ — сайт с документацией на Astro Starlight. Инструментарий разработки включает @sparkle/config для общих конфигураций сборки, линтинга и Tailwind; @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. Репозиторий также отслеживает архитектурные решения в git-native графе решений через Deciduous. В коммиты попадают только .deciduous/config.toml и .deciduous/sync/; кэш SQLite, narratives.md и documents/ игнорируются git. В README описан кастомный merge driver для .deciduous/sync/** и отмечено, что может потребоваться ручное разрешение конфликтов, а также возможны сбои слияния, если deciduous CLI отсутствует в PATH. В README содержатся ссылки на сайт с документацией, Storybook, инструкции для copilot и рабочий процесс Changesets. Проект распространяется под лицензией MIT.