v0 プロジェクトをGithub連携でローカルセットアップする手順書(Bun用)

0. 事前条件

要件	コマンド
Bun v1.0 以上	`bun -v` ▼ 古い場合 → `bun upgrade`
GitHub SSH 権限	`ssh -T git@github.com` で認証確認
空 or 既存の GitHub リポ	例: `git@github.com:noricha-vr/v0-hack-type.git`

1. リポジトリを作る／クローンする

🆕 リポジトリがまだ無い場合

# ZIP を展開したフォルダへ移動
cd ~/Downloads/v0-hack-type

# Git 初期化 & 最初のコミット
git init -b main
git add -A
git commit -m "feat: 🎨 bootstrap from v0 export"

# GitHub にリポジトリを作成して Remote 登録
git remote add origin git@github.com:noricha-vr/v0-hack-type.git
git push -u origin main

📥 すでにリモートがある場合（例: v0 が自動 Push 済）

# 1) まずクローン
git clone git@github.com:noricha-vr/v0-hack-type.git
cd v0-hack-type

# 2) （v0 ZIP を上書きしたい場合）ファイルをコピーしてコミット
cp -R ~/Downloads/v0-export/* .
git add -A
git commit -m "feat: overwrite with latest v0 export"

# 3) リモートを更新
git pull --rebase origin main   # ← 競合がなければこれで整合
git push origin main

2. 依存パッケージをインストール

bun install

Warnings
incorrect peer dependency は無視して OK（React 19 & Tailwind 3.x への警告）。

3. shadcn/ui の初期化が必要か確認

ls -1 | grep -E 'tailwind.config.(js|ts)$'
ls -1 | grep '^components.json$'

出力	次のアクション
両方ある → `tailwind.config.ts/js` & `components.json`	★ すでに初期化済み → この章はスキップ
どちらか無い	`bunx shadcn@latest init` を実行

# 初期化コマンド（必要な場合のみ）
bunx shadcn@latest init

既に components.json があると
A components.json file already exists … が出ます → その場合は skip して OK。

4. v0 で新しい UI を取り込むフロー

v0 エディタ右上 → 「コードベースに追加」 をクリック
表示されるコマンドをコピーして実行

# 例：ログイン画面を追加
bunx shadcn@latest add "https://v0.dev/t/AbCdEfGh..."
bun install            # 依存が増えた場合のみ

動作確認 → Git にコミット

git add -A
git commit -m "feat(ui): add login page from v0"
git push origin main

5. 開発サーバーを起動

bun dev   # -> http://localhost:3000

6. よくあるトラブル & 解決策

症状	対処
`zsh: command not found: bunx`	Bun が古い → `bun upgrade`
`Script not found "dlx"`	Bun には `dlx` が無く `bunx` を使う
`components.json already exists` エラー	すでに初期化済：スキップ可能
Git push で `! [rejected] main -> main (fetch first)`	`git pull --rebase origin main` → 競合解消後 `git push`
React 19 peer warning	現在の shadcn/ui は React 19 対応済みなので問題なし

7. デプロイ（任意）

GitHub リポが Vercel に接続済みなら main ブランチ push ➜ 自動デプロイ
環境変数は Vercel ダッシュボード → Environment Variables で管理し
ローカルへは vercel env pull → .env.local を生成