web-artifacts-builder

Web Artifacts ビルダー

強力なフロントエンド claude.ai アーティファクトを作成するには、次の手順に従ってください。

1. scripts/init-artifact.sh を使ってフロントエンドのリポジトリを初期化します
2. 生成されたコードを編集してアーティファクトを開発します
3. scripts/bundle-artifact.sh を使ってすべてのコードを単一の HTML ファイルにバンドルします
4. アーティファクトをユーザーに表示します
5. （任意）アーティファクトをテストします

スタック：React 18 + TypeScript + Vite + Parcel（バンドル）+ Tailwind CSS + shadcn/ui

デザインとスタイルのガイドライン

非常に重要：「AI slop」と呼ばれることが多いものを避けるため、中央揃えのレイアウト、紫のグラデーション、均一な角丸、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

これにより、JavaScript、CSS、依存関係がすべてインライン化された、自己完結型のアーティファクト bundle.html が作成されます。このファイルは、アーティファクトとして 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