クイックスタート
開発環境を構築し、最初のローカル起動までの手順です。
| ツール | バージョン | 確認コマンド |
|---|---|---|
| Node.js | 22+ | node -v |
| Bun | 1.1.38+ | bun -v |
| Git | 最新 | git -v |
1. リポジトリのクローン
Section titled “1. リポジトリのクローン”git clone https://github.com/shoya-kimura/speakeasy.gitcd speakeasy2. 依存関係のインストール
Section titled “2. 依存関係のインストール”bun installTurborepo のワークスペース構成により、すべてのアプリ・サービス・パッケージの依存関係が一括でインストールされます。
3. 環境変数の設定
Section titled “3. 環境変数の設定”cp .dev.vars.example .dev.vars.dev.vars を編集し、必要なシークレット（データベース接続文字列、API キーなど）を設定します。詳細は環境構成を参照してください。
4. 開発サーバーの起動
Section titled “4. 開発サーバーの起動”全サービス一括起動
Section titled “全サービス一括起動”bun devすべてのアプリ・サービスが並行して起動します。
Counter アプリのみ起動
Section titled “Counter アプリのみ起動”Counter と依存サービス（Fizz, Vintage）のみを起動する場合:
bun dev:counterハイブリッドモード（推奨）
Section titled “ハイブリッドモード（推奨）”ローカルのフロントエンドからリモート dev 環境のサービスに接続:
bun dev:hybrid.dev.vars でローカル実行するサービスを個別に指定できます:
# .dev.vars — ローカルで実行するサービスのみコメント解除LOCAL_VINTAGE_URL=http://127.0.0.1:8787# LOCAL_FIZZ_URL=http://127.0.0.1:8788 # Fizz はリモート dev を使用5. アクセス確認
Section titled “5. アクセス確認”起動後、以下の URL にアクセスできます:
| アプリ | URL | 説明 |
|---|---|---|
| Counter | http://localhost:5174 | 店舗管理アプリ |
| Penthouse | http://localhost:5173 | システム管理アプリ |
| Storybook | http://localhost:5175 | UI コンポーネント |
6. よく使うコマンド
Section titled “6. よく使うコマンド”品質チェック
Section titled “品質チェック”bun lint # ESLintbun typecheck # TypeScript 型チェックbun format # Prettier フォーマット# パッケージ単位でテスト実行cd packages/cellar && bun testcd services/fizz && bun testcd services/vintage && bun testデータベース
Section titled “データベース”cd packages/cellar
bun run generate # マイグレーションファイル生成bun run migrate:dev # dev 環境にマイグレーション適用bun run studio:dev # Drizzle Studio（dev 環境）Cloudflare Workers 型生成
Section titled “Cloudflare Workers 型生成”bun cf-typegen各サービスの worker-configuration.d.ts が更新されます。wrangler.jsonc のバインディング変更後に実行してください。