artifacts-builder

Artifacts Builder

高機能なフロントエンド 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 スロップ」と呼ばれることが多い状態を避けるため、中央揃えのレイアウト、紫色のグラデーション、均一な角丸、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