ProductReadyProductReady

クイックスタート

ProductReadyを10分で動かす - ゼロからデプロイまで

クイックスタート

ProductReadyへようこそ!🚀 このガイドでは、10分以内にゼロから動作するアプリまで進めます。

ProductReadyは初めて? まずデモモードを試してください - データベース設定は不要です!


表示される内容

セットアップ後、ProductReadyはすぐに使える複数の事前構築ページを提供します。探索できる内容は次のとおりです:

ページルート説明スクリーンショット
ランディングページ/ヒーローセクション、機能、CTAを含むマーケティングホームページ準備中
ダッシュボード/dashboardタスク管理と分析を含むメインアプリケーションダッシュボード準備中
エージェントタスク/agentAIエージェントタスクの作成と監視インターフェース準備中
システム管理/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ボイラープレートから開始

新しいものを構築していて、次のものが必要です:

  • 本番環境対応の基盤
  • すぐに使える最新のアーキテクチャ
  • AI搭載の初期化
  • デフォルトでのベストプラクティス

所要時間: 5分 + AIセットアップ

新規プロジェクトガイドへ →

🔄 既存プロジェクト

ProductReadyパターンを採用

既存のアプリがあり、次のことをしたい:

  • アーキテクチャの最新化
  • 型安全なAPI(tRPC)の追加
  • 認証の改善(Better Auth)
  • データベースレイヤーの改善(Drizzle)

所要時間: 30-60分 + AI移行

移行ガイドへ →

ただ探索したいだけ? まずデモモードを試してください - セットアップ不要、2分ですべて確認できます!


前提条件

開始する前に、次のものがあることを確認してください:


デモモード

最速の方法 - データベースなしでProductReadyを試す!

完了! 🎉 認証やデータベースなしですべての機能を探索できます。


新規プロジェクト

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パターンを統合します。

これは高度なガイドです。時間をかけて各ステップを理解してください。

アプローチ

  1. 段階的な移行 - すべてを一度に書き換えないでください
  2. パターンを採用 - ProductReadyのベストプラクティスをコピー
  3. 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つのページまたは機能を移行:

  1. ProductReadyから関連コードをコピー
  2. プロジェクトに適応
  3. AIを使用して移行を支援

ステップ 4: パターンを繰り返し

移行プロセスを繰り返し:

  • データベーススキーマ → Drizzle ORM
  • API → tRPC
  • 認証 → Better Auth
  • UI → Shadcn/UI + Tailwind

次のステップ

ProductReadyが実行されたら:

  1. **プロジェクト構造**を読む - すべてがどこにあるかを理解
  2. **認証**を設定 - ユーザーログインとOAuth
  3. **データベース**を理解 - スキーマとクエリ
  4. **課金**を追加 - Stripeサブスクリプション
  5. デプロイ - Vercelに本番環境をデプロイ

トラブルシューティング

問題が発生しましたか?トラブルシューティングガイドを確認してください。


ヘルプが必要ですか?

ProductReadyで構築を楽しんでください! 🚀

On this page