このプロジェクトについて

Sparkleは、モダンなWeb、モバイル、およびWASM開発パターンの探索を目的としたTypeScriptプレイグラウンド・モノレポとして説明されています。READMEでは、これが実験的なものであること、およびAPIとアーキテクチャが積極的に進化することが記されています。 ワークスペースにはTurborepoとpnpmが使用されており、Node.js >=22.13.1およびpnpm >=10が必要です。クローン後、pnpm bootstrapで依存関係をインストールし、pnpm devでフル開発環境を起動します。 コアパッケージには、Radix UIプリミティブとTailwind CSSに基づいて構築されたアクセシブルなReactコンポーネントライブラリである@sparkle/ui、Webおよびネイティブ向けのクロスプラットフォーム・デザイントークンとテーマプロバイダーである@sparkle/theme、共有TypeScript型定義の@sparkle/types、およびユーティリティ関数とReactフックの@sparkle/utilsが含まれます。 アプリケーションおよびサポートワークスペースには、Expo / React Nativeモバイルアプリのapps/fro-jive、Zigでコンパイルされた実行ファイルとxterm.jsを備えたWASM駆動のウェブシェルのapps/moo-dang、コンポーネントドキュメント、プレイグラウンド、視覚的テスト用のpackages/storybook、およびAstro Starlightドキュメントサイトのdocs/があります。 開発ツールには、共有ビルド、リント、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ネイティブな決定グラフでアーキテクチャ上の決定を追跡しています。.deciduous/config.tomlと.deciduous/sync/のみがコミットされ、SQLiteキャッシュ、narratives.md、およびdocuments/はgitignoreされています。READMEでは、.deciduous/sync/**用のカスタムマージドライバーについて説明されており、手動での競合解決が必要な場合があることや、deciduous CLIがPATHにない場合にマージが失敗する可能性があることが記されています。 READMEには、ドキュメントサイト、Storybook、Copilot指示書、およびChangesetsワークフローへのリンクがあります。ライセンスはMITです。