メインコンテンツまでスキップ

クイックスタート

5分でBazbiiの開発環境を起動します。

前提条件​

以下のツールがインストールされている必要があります：

  • Go 1.25+
  • Node.js 22+
  • pnpm 10.18.1
  • Docker & Docker Compose
  • buf (Protocol Buffers)

💡 インストール方法は開発環境セットアップを参照してください。

5分で動かす​

1. リポジトリをクローン​

git clone <repository-url>
cd bazbii

2. 依存関係をインストール​

# フロントエンド依存関係
pnpm install

# Go依存関係
make go/tidy

3. データベースを起動​

# PostgreSQLコンテナ起動
make compose/db.up

# マイグレーション実行
make db/mig-up

4. アプリケーションを起動​

# 全コンテナ起動
make compose/up

5. 動作確認​

# ヘルスチェック
curl http://localhost:3000/healthz

成功すれば、開発環境が起動しています！

次のステップ​

トラブルシューティング​

ポートが使用中​

# 使用中のポートを確認
sudo lsof -i :5432  # PostgreSQL
sudo lsof -i :8080  # API Server
sudo lsof -i :3000  # Gateway

コンテナが起動しない​

# コンテナを停止して再起動
make compose/down
make compose/up

詳しいトラブルシューティングは開発環境セットアップを参照してください。