クイックスタート
ProductReadyを10分で動かす - ゼロからデプロイまで
クイックスタート
ProductReadyへようこそ!🚀 このガイドでは、10分以内にゼロから動作するアプリまで進めます。
ProductReadyは初めて? まずデモモードを試してください - データベース設定は不要です!
表示される内容
セットアップ後、ProductReadyはすぐに使える複数の事前構築ページを提供します。探索できる内容は次のとおりです:
| ページ | ルート | 説明 | スクリーンショット |
|---|---|---|---|
| ランディングページ | / | ヒーローセクション、機能、CTAを含むマーケティングホームページ | 準備中 |
| ダッシュボード | /dashboard | タスク管理と分析を含むメインアプリケーションダッシュボード | 準備中 |
| エージェントタスク | /agent | AIエージェントタスクの作成と監視インターフェース | 準備中 |
| システム管理 | /systemadmin | システム管理パネル(管理者権限が必要) | 準備中 |
ライブデモ利用可能! ?demo=1パラメータを付けてすべてのルートにアクセス(例:/dashboard?demo=1)すると、認証なしで探索できます。
クイックアクセスリンク:
- 🏠 ランディングページ:
http://localhost:3000/ - 📊 ダッシュボード:
http://localhost:3000/dashboard(または/dashboard?demo=1) - 🤖 エージェントタスク:
http://localhost:3000/agent(または/agent?demo=1) - ⚙️ システム管理:
http://localhost:3000/systemadmin(または/systemadmin?demo=1)
注意:スクリーンショットは次のドキュメント更新時に追加されます。今のところ、開発サーバーを起動して、これらのルートを自分で探索してください!
ProductReadyを使用する2つの方法
ProductReadyは2つのシナリオであなたを支援できます:
🆕 新規プロジェクトProductReadyボイラープレートから開始 新しいものを構築していて、次のものが必要です:
所要時間: 5分 + AIセットアップ | 🔄 既存プロジェクトProductReadyパターンを採用 既存のアプリがあり、次のことをしたい:
所要時間: 30-60分 + AI移行 |
ただ探索したいだけ? まずデモモードを試してください - セットアップ不要、2分ですべて確認できます!
前提条件
開始する前に、次のものがあることを確認してください:
- Node.js 24.18.0 LTS - ここからダウンロード
- pnpm - インストール:
npm install -g pnpm - Git - ここからダウンロード
- PostgreSQLデータベース (オプション - デモモードではスキップ可能)
デモモード
最速の方法 - データベースなしでProductReadyを試す!
ステップ 1: リポジトリをクローン
git clone https://github.com/mr-kelly/productready.git
cd productreadyステップ 2: 依存関係をインストール
pnpm installステップ 3: デモモードで実行
pnpm devステップ 4: ブラウザで開く
http://localhost:3000を開き、任意のページに?demo=1を追加します:
完了! 🎉 認証やデータベースなしですべての機能を探索できます。
新規プロジェクト
ProductReadyから新しいプロジェクトを開始します。
ステップ 1: リポジトリをクローン
git clone https://github.com/mr-kelly/productready.git my-app
cd my-appステップ 2: 依存関係をインストール
pnpm installステップ 3: 環境変数を設定
.env.exampleを.envにコピー:
cp .env.example .env.envファイルを編集して、データベースURL、認証キー、Stripeキーを設定します。
ステップ 4: データベースをセットアップ
pnpm db:push
pnpm db:seedステップ 5: 開発サーバーを起動
pnpm devステップ 6: ブラウザで開く
http://localhost:3000を開きます。
完了! 🎉 ProductReadyが実行されました。プロジェクト構造を読んで、次に何をすべきかを理解しましょう。
既存プロジェクトのリファクタリング
既存のプロジェクトにProductReadyパターンを統合します。
これは高度なガイドです。時間をかけて各ステップを理解してください。
アプローチ
- 段階的な移行 - すべてを一度に書き換えないでください
- パターンを採用 - ProductReadyのベストプラクティスをコピー
- AIを使用 - Claude/Cursorにコード移行を支援させる
ステップ
ステップ 1: ProductReadyをローカルで実行
まず、ProductReadyがローカルで動作することを確認します:
git clone https://github.com/mr-kelly/productready.git
cd productready
pnpm install
pnpm devステップ 2: パターンを理解
次を読む:
ステップ 3: 1つの機能を移行
小さく始める - 1つのページまたは機能を移行:
- ProductReadyから関連コードをコピー
- プロジェクトに適応
- AIを使用して移行を支援
ステップ 4: パターンを繰り返し
移行プロセスを繰り返し:
- データベーススキーマ → Drizzle ORM
- API → tRPC
- 認証 → Better Auth
- UI → Shadcn/UI + Tailwind
次のステップ
ProductReadyが実行されたら:
- **プロジェクト構造**を読む - すべてがどこにあるかを理解
- **認証**を設定 - ユーザーログインとOAuth
- **データベース**を理解 - スキーマとクエリ
- **課金**を追加 - Stripeサブスクリプション
- デプロイ - Vercelに本番環境をデプロイ
トラブルシューティング
問題が発生しましたか?トラブルシューティングガイドを確認してください。
ヘルプが必要ですか?
ProductReadyで構築を楽しんでください! 🚀