Registryの構造

ソースの管理場所、生成エンドポイント、依存関係とインストールの範囲を説明します。

ソースの管理場所

パス管理する内容
registry/src/components/ui導入可能なUIの基本要素
registry/src/components/blocksテンプレート、作業画面とチャート例
registry/src/lib共通ユーティリティと分析データモデル
registry/src/theme.tsプリセットデータとトークン計算
registry/catalog.json項目のメタデータと依存関係の宣言

生成物

  • registry/registry.json · registry/public/r — レジストリのソースから生成します。
  • docs/public/r — ドキュメントでも同じ導入エンドポイントを提供するために複製します。
  • docs/src/registry — 同期されたビルド入力で、Git管理から除外します。別の原本ではありません。
  • 生成CSSとテーマの初期化スクリプトは同じテーマエンジンから作ります。

インストールの流れ

@neumorphism-ui — 名前空間は一つのURLテンプレートで解決します。shadcnは各項目に宣言されたレジストリ依存関係をたどります。コンポーネントを追加する前に共通の基本テーマを一度導入してください。

https://neumorphism-ui.andongmin.com/r/{name}.json
npx shadcn@latest add @neumorphism-ui/button

全項目の独立インストール検査はローカル、または手動の包括的ワークフローで実行します。テンプレートは新しいNext.jsプロジェクトで、その他のファイルを含む項目はNext.jsとViteの両方でビルドします。通常のCIは代表的な利用側プロジェクトを検査します。

ディレクトリのメタデータ

registry/directory-entry.json — 名前空間、ホームページ、エンドポイントのテンプレート、説明とインラインロゴを保存します。ファイルの存在はディレクトリへの申請や承認を意味しません。

責任の範囲

  • アプリケーションの認証、権限、永続化、ルーティングと業務データはレジストリが管理しません。
  • 導入時にアプリケーション所有のCSS、変更済みソース、別名やルートを上書きしてはいけません。
  • 廃止したパスは互換用の別名を残さずに削除します。

コンポーネントを見る →