starwind-pro

Starwind Pro

Starwind Pro は Starwind UI v3 を基盤としています。公開ブロックは引き続き Astro コンポーネントとしてアプリケーションにインストールされ、ローカルでカスタマイズされます。

ルール

• Pro ブロックを選択する前に、対象が Astro であることを確認してください。
• starwind.config.json を、フレームワーク、コンポーネントの配置先、レジストリ、Tailwind、Pro の認可設定に関する V3 の正式な設定として扱ってください。
• Starwind UI がない場合は starwind init --framework astro --pro で初期化し、既存のプロジェクトでは starwind setup を使用してください。
• ブロック名を挙げる前に、最新の MCP、CLI、または Pro メタデータを検索してください。
• 返された正確なインストールコマンドを使用し、宣言されているコンポーネントの依存関係を維持してください。
• デモコンテンツを置き換える際は、ブロックのレスポンシブレイアウト、コンテナークエリ、モーションと動きを抑える設定の動作、アクセシビリティ、ライト／ダークテーマの仕様を維持してください。
• 無料ブロックとプレミアムブロックを区別してください。プレミアムブロックの利用にはアクセス権が必要です。利用可否はメタデータで確認してください。
• STARWIND_LICENSE_KEY は .env.local またはシークレットマネージャーに保管し、コード、ログ、チャット、引き継ぎ文には含めないでください。

コンテキスト

ブロックを推奨またはインストールする前に、次の項目を確認してください。

1. package.json、ロックファイル、astro.config.*、変更対象のルート／レイアウト。
2. starwind.config.json、設定済みのコンポーネントディレクトリ、インストール済みの記録、ローカルエクスポート。
3. 設定で指定されている Starwind の CSS ファイルと、既存のテーマ規約。
4. セットアップによって .env.local が作成または更新される可能性がある場合は、.gitignore。

古い components.json に旧 Pro レジストリ設定が含まれている場合、現在のセットアップではそれらをインポートできますが、内容が異なる場合は starwind.config.json が優先されます。

検索、インストール、適応

1. 新規プロジェクトでは starwind init --framework astro --pro で初期化します。Starwind の初期化済みプロジェクトでは、Pro の設定がない場合に一度 starwind setup を実行します。
2. 最新の MCP starwind_search または starwind search <query> --json を使用して、目的／カテゴリ／プランで検索します。
3. プランと依存関係がプロジェクトに合う結果を選択します。
4. プロジェクトのルートから、表示された正確なインストールコマンドを実行します。
5. 追加されたすべてのブロックとコンポーネントのファイルを確認します。
6. ローカルエイリアスを使って、目的の Astro ルートに組み込みます。
7. レスポンシブ、コンテナークエリ、アニメーション、アクセシビリティ、テーマの動作を維持しながら、プレースホルダーのコンテンツ、リンク、データ、画像を置き換えます。
8. 関連するフォーマット、型チェック、ビルド、ページ／ブラウザーのチェックを実行します。

ソースと依存関係が設定済みの場所にインストールされ、プレースホルダーのコンテンツが解決され、インポートを含むビルドが成功し、アクセス要件が正確に報告されたら、ブロックの作業は完了です。

参照

• setup.md：V3 Pro の設定、ライセンスの境界、トラブルシューティング
• blocks.md：検索、インストールコマンド、適応