StorefrontUI(@storefront-ui/react・@storefront-ui/vue)は、ECサイト向けのUIコンポーネントを提供するReact・Vue用のフロントエンドライブラリです。このリポジトリは、そのライブラリを開発するmonorepoで、ドキュメントサイト、動作確認用のプレビューアプリ、リリース管理の設定を含みます。
リポジトリはmonorepo構成です。.changeset/config.json のignore欄に @storefront-ui/preview-next、preview-nuxt、tests、vue-test、react-test などのワークスペース名があり、パッケージごとに分かれていることが確認できます。 apps/docs/components はNuxtで作られたドキュメントサイトです。content配下のmdで components、blocks、hooks、getting-started を管理し、pages/[framework]/components/[component].vue という動的ルートで React・Vue を切り替えて表示します。ReactOnly.vue と VueOnly.vue というコンポーネントも、フレームワーク別の表示に使われていると読み取れます。 _templates/component/new には、React・Vueのコンポーネント、型定義、index、テスト、ドキュメントmdの雛形があります。拡張子が .ejs.t なので、Hygen系のジェネレーターを使う想定と推定されますが、確証はありません。 リリースは .changeset で管理され、baseBranch は origin/v2、changelogはGitHub連携の設定です。ビルドは Dockerfile で node:22-alpine を使い、yarn、build:replace-assets-url-with、build:vue、build:docs、serve の順に実行されます。apps/preview の next と nuxt は、それぞれのフレームワークでの組み込み確認に使われると読み取れます。 なお、packages配下のコンポーネント実装は提示されたツリーに含まれておらず、内部の仕組みは確認できていません。
- STEP 01
リポジトリをクローンし、Dockerfileに合わせてNode 22系を用意すると、Yarn 4(.yarn/releases/yarn-4.12.0.cjs)でyarnを実行できる状態になります。
- STEP 02
ルートで yarn を実行して依存関係をインストールし、続けて yarn build:vue と yarn build:docs を実行すると、ビルドの成否がターミナルに表示されます。
- STEP 03
apps/docs/components で yarn serve を実行し、表示されたURLを開くと、Nuxtのドキュメントサイトのトップページが見えます。
- STEP 04
/react/components/button のようなURLを開き、同じコンポーネントのReact版とVue版の説明が切り替わるかを確認します(ページ構成からの推定で、実際の表示は未確認です)。
- STEP 05
_templates/component/help のテンプレートを読むと、コンポーネントの雛形生成の手順を確認できます。
実行すると、ドキュメントサイトのビルドと起動が確認でき、コンポーネント、ブロック、フックの各ページを閲覧できる状態になります。あわせて、Next.jsとNuxtのプレビュー環境も用意されている構成です。ただし、これらの結果から得られるのは、ドキュメントと開発基盤が動くことの確認までです。ライブラリ本体のコンポーネントの見た目や挙動は、このツリーの範囲では確認できません。
提示されたファイルツリーは途中で切れており、packages配下のコンポーネント実装とテストは確認できていません。
READMEとして渡された内容はChangesetsの説明文のみで、インストール手順や利用例は含まれていません。
Dockerfileやワークフローはvuestorefrontcloudへのデプロイを前提としており、そのまま別環境で動かすには設定の変更が必要と思われます。
ドキュメントのビルドはVITE_DOCS_BASEPATHなどの環境変数を前提としており、未設定の場合の挙動は確認できていません。
このリポジトリは、ReactやVueでECサイトのUIを組みたい開発者や、コンポーネントの使い方を調べたい方に向いています。ライブラリ本体を組み込んで使う方は、npmパッケージの利用が中心になります。提示された判断は、ファイル構成、Dockerfile、changeset設定といった実在する記述に基づいています。一方で、コンポーネントの内部実装と動作は未検証です。導入前に実際のコンポーネントを確認したい場合は、対象コンポーネントのソースとテスト結果をあわせて見ることをおすすめします。