Taroify：Vant の Taro React コンポーネントライブラリ

Vant の Taro React 版

Taroify はモバイル UI コンポーネントライブラリで、README では Vant の Taro React 版として位置づけられています。Vant は Youzan がメンテナンスするモバイルコンポーネントライブラリです。両プロジェクトは同じ視覚仕様を共有し、ほぼ同一の API を提供するため、Vant を扱ったことのある開発者は、Taro ベースのミニプログラムを構築する際に同じパターンを適用できます。README は Taroify を軽量で信頼性が高いと説明し、ミニプログラムと H5 の両方に対応するとしています。プロジェクトは TypeScript で書かれており、リポジトリのメタデータも TypeScript を主要言語として確認しています。リポジトリのホームページは taroify.com で、公式サイト、クイックスタート、オンラインデモ、CLI/MCP、ディスカッションへの入口が提供されています。メタデータには 1,087 スター、122 フォーク、15 のオープン issue が記録されており、プロジェクトはアーカイブされておらず、デフォルトブランチは main です。README は API が Vant のどのバージョンに対応するかを明記しておらず、2 つのライブラリの違いも列挙していません。

コンポーネントのサイズ、テストカバレッジ、テーマ変数

README はライブラリの特性についていくつかの具体的な数値を示しています。コンポーネントの平均サイズは 1KB 未満（min+gzip）とされています。ライブラリには 70 以上のコンポーネントが含まれ、モバイルの主流シナリオをカバーします。単体テストのカバレッジは 90 パーセント以上と報告されています。テーマシステムは 700 以上の変数を公開し、ライブラリはオンデマンドインポートと Tree Shaking をサポートします。README はまた、完全な中国語ドキュメントとコンポーネントの例、React のサポートにも言及していますが、どの React バージョンがサポートされるか、特定の React メジャーバージョンとの互換性がどのように検証されるかは書かれていません。1KB 平均がどのように計算されたか、70 以上のコンポーネントがどのシナリオに分類されるか、カバレッジがどのように測定されたかも説明されていません。テーマ変数の完全なリストと推奨される上書き方法も含まれておらず、ドキュメントサイトに委ねられています。

@taroify/core のインストールとボタンの描画

README は npm、Yarn、pnpm によるインストール方法を記載しています。npm コマンドは npm install @taroify/core、同等のコマンドは yarn add @taroify/core と pnpm add @taroify/core です。使用例では、@taroify/core から Button をインポートし、@taroify/core/button/style からボタンのスタイルをインポートして、color プロパティを primary に設定したボタンを描画します。これは README にある唯一の完全なコンポーネント例です。README は、より簡潔なソースコードとより小さなビルド成果物のために、自動オンデマンドインポートの設定を推奨し、完全な設定については taroify.com のクイックスタートページを案内しています。正確な設定手順は README にはなく、Babel プラグイン、PostCSS 設定、Taro のビルドファイルの変更が必要かどうかも書かれていません。既存プロジェクトが満たすべき Taro や React のバージョン要件も明記されていません。

モノレポ内の 6 つのパッケージ

Taroify はモノレポとして構成され、6 つのパッケージを個別にインストールして組み合わせることができます。@taroify/core はコア UI コンポーネントとテーマシステムを含みます。@taroify/icons は Taro React アイコンコンポーネントを提供します。@taroify/hooks はコンポーネントとビジネスシナリオ向けの React Hooks を含みます。@taroify/commerce は EC シナリオ向けの拡張コンポーネントを追加します。@taroify/cli はオフラインのコンポーネント知識 CLI、MCP、Agent Skill として説明され、@taroify/mcp はスタンドアロンの MCP サービスです。README は各パッケージについて 1 行の説明しか与えていません。@taroify/commerce にどの EC コンポーネントが含まれるか、CLI の知識ベースがどのように維持されるか、Agent Skill が何を指すか、MCP サービスが実際にどう使われる想定かは書かれていません。パッケージ間の依存関係、バージョンリリース戦略、バージョン整合性についても README には情報がなく、npm ページかドキュメントサイトで確認する必要があります。

ブラウザサポートとローカル開発

README は、Taroify がモダンブラウザ、Chrome 51 以上、iOS 10.0 以上をサポートすると述べています。Android のバージョンや特定のミニプログラムプラットフォームのバージョン要件には触れておらず、これらのブラウザターゲットがどのようにテストされているかも説明されていません。ローカル開発では、リポジトリをクローンし、pnpm run install:node_modules を実行してルート、ワークスペース、ウェブサイトの依存関係をインストールし、pnpm develop を実行して H5 コンポーネントの例とドキュメントサイトを起動します。README はリポジトリ構造、コンポーネント開発、コミット規約についてコントリビューションガイドを参照するよう案内していますが、その内容は要約していません。ローカル環境の Node.js や pnpm の最低バージョンも記載されていません。CI ステータスとコードカバレッジのバッジは README に表示されていますが、CI パイプライン自体は説明されていません。

コミュニティ、謝辞、MIT ライセンス

README は GitHub の Issue、Pull Request、Discussions を通じた参加を呼びかけ、チェンジログへのリンクを提供しています。すべてのコントリビューターに感謝し、グラフィックデザインの一部を @BiscuitCoder によるものとし、Vant チームによるデザイン仕様と多くのコンポーネント経験、JetBrains による開発ツールのサポートに謝意を表しています。また、Vant 公式エコシステムプロジェクト（Vant、Vant Weapp、Vant Demo、Vant CLI、Vant Icons、Vant Touch Emulator）とコミュニティプロジェクト（React Vant、mockm、taro-hooks、tarojs-router-next）を参考リンクとして挙げていますが、Taroify とそれらのプロジェクトの間のコードや依存関係については述べていません。ライセンスは MIT で、著作権は 2021 年から現在まで Zhi Tang に帰属します。MIT のテキストは、ソフトウェアのコピーの使用、複製、変更、統合、公開、配布、再ライセンス、販売を許可し、ソフトウェアが無保証で提供されることを定めています。ライセンスはサポート、セキュリティ、メンテナンスの義務について何も述べておらず、README もそのような約束をしていません。

編集部の結論

Taroify は Vant の視覚仕様に従う Taro React コンポーネントライブラリで、70 以上のコンポーネント、TypeScript の型定義、6 つのパッケージからなるモノレポ構成を備えています。MIT ライセンスは使用、変更、再配布を許可しますが、README はサポート、セキュリティ、今後のメンテナンスについて一切言及していません。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes