Web Artifacts Builder(Webアーティファクトビルダー) は何をしますか?
強力なフロントエンドclaude.aiアーティファクトを構築するには、次の手順に従ってください:
scripts/init-artifact.shを使用してフロントエンドリポジトリを初期化する- 生成されたコードを編集してアーティファクトを開発する
scripts/bundle-artifact.shを使用してすべてのコードを単一のHTMLファイルにバンドルする- アーティファクトをユーザーに表示する
- (オプション)アーティファクトをテストする
スタック: React 18 + TypeScript + Vite + Parcel(バンドル)+ Tailwind CSS + shadcn/ui
デザインとスタイルのガイドライン
非常に重要:いわゆる「AIスロップ」を避けるため、過度な中央寄せレイアウト、紫のグラデーション、統一された角丸、Interフォントの使用は避けてください。
クイックスタート
ステップ1:プロジェクトの初期化
初期化スクリプトを実行して新しいReactプロジェクトを作成します:
bash scripts/init-artifact.sh <project-name>
cd <project-name>
これにより、以下の設定が完了したプロジェクトが作成されます:
- ✅ React + TypeScript(Vite経由)
- ✅ shadcn/uiテーマシステムを備えたTailwind CSS 3.4.1
- ✅ パスエイリアス(
@/)が設定済み - ✅ 40以上のshadcn/uiコンポーネントがプリインストール
- ✅ すべてのRadix UI依存関係を含む
- ✅ Parcelがバンドリング用に設定済み(.parcelrc経由)
- ✅ Node 18+互換性(Viteバージョンを自動検出して固定)
ステップ2:アーティファクトの開発
アーティファクトを構築するには、生成されたファイルを編集します。ガイダンスについては、以下の一般的な開発タスクを参照してください。
ステップ3:単一HTMLファイルへのバンドル
Reactアプリを単一のHTMLアーティファクトにバンドルするには:
bash scripts/bundle-artifact.sh
これにより、bundle.htmlが作成されます。これは、すべてのJavaScript、CSS、依存関係がインライン化された自己完結型のアーティファクトです。このファイルは、Claude会話内でアーティファクトとして直接共有できます。
要件: プロジェクトのルートディレクトリにindex.htmlが必要です。
スクリプトの処理内容:
- バンドル依存関係(parcel、@parcel/config-default、parcel-resolver-tspaths、html-inline)をインストール
- パスエイリアスをサポートする
.parcelrc設定を作成 - Parcelを使用してビルド(ソースマップなし)
- html-inlineを使用してすべてのアセットを単一のHTMLにインライン化
ステップ4:アーティファクトをユーザーと共有
最後に、バンドルされたHTMLファイルをユーザーとの会話で共有し、アーティファクトとして表示できるようにします。
ステップ5:アーティファクトのテスト/視覚化(オプション)
注:これは完全にオプションの手順です。必要な場合または要求された場合にのみ実行してください。
アーティファクトをテスト/視覚化するには、利用可能なツール(他のスキルやPlaywright、Puppeteerなどの組み込みツールを含む)を使用します。一般的には、リクエストから完成したアーティファクトが表示されるまでのレイテンシが増加するため、アーティファクトを事前にテストすることは避けてください。問題が発生した場合や要求された場合に、アーティファクトを提示した後にテストしてください。
リファレンス
- shadcn/uiコンポーネント: https://ui.shadcn.com/docs/components