集酒 開発環境構築手順

作成 2026-09-17 JST ／ 対象: shushu-app（Expo SDK 54・React Native 0.81）と shushu-supabase（Supabase ローカル）

新しく参加したメンバーが、自分の Mac でローカルの Supabase にテストデータを入れ、iOS シミュレータでアプリにログインできるところまでを通しで書いています。クラウド（本番の Supabase・EAS・RevenueCat・ストア）には触らない手順です。

01全体像

ローカルでは次の形で繋がります。

• Supabase CLI が Docker の中に DB・認証・Storage・API を立てる（API は http://127.0.0.1:54321、DB は 54322、管理画面 Studio は 54323）
• アプリは .env に書いたローカルの URL と公開鍵で、その API を見る
• アプリは MMKV・RevenueCat などネイティブのモジュールを使うため、Expo Go では動きません。開発用ビルド（expo-dev-client 入りの「shushu (Dev)」）を一度ビルドしてシミュレータに入れ、あとは Metro（JS の配信サーバー）から JS を読み込みます
• 開発用ビルドの Bundle ID は com.felisnow.shushu.dev（本番 com.felisnow.shushu と並べて入れられる）。切り替えは環境変数 APP_VARIANT=development

02アクセス権をもらう

3 つのリポジトリはすべて 非公開（private） です。オーナー（岡橋）に GitHub のユーザー名を伝えて、招待を受けてください。

GitHub に HTTPS で入れるように、GitHub CLI でログインしておくと楽です（ツールは次の章で入れます）。

gh auth login

03ツールを入れる

前提は macOS（Apple Silicon）。右の列は、既存メンバーの Mac で 2026-09-17 に動いているバージョンです（--version で確認）。

Homebrew

入っていなければ brew.sh のインストールコマンドを実行してください。

コマンドラインのツール

brew install git gh node@20 cocoapods supabase/tap/supabase libpq

node@20 と libpq は PATH に自動では入らないので、シェルの設定に足します。

echo 'export PATH="/opt/homebrew/opt/node@20/bin:/opt/homebrew/opt/libpq/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Xcode

1. App Store から Xcode を入れて、一度起動する（追加コンポーネントのインストールと iOS シミュレータのランタイムの取得まで済ませる）
2. コマンドラインツールの向き先を Xcode にする

sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -license accept
xcrun simctl list devices available | head

Docker

Docker Desktop か Rancher Desktop を入れて起動しておきます（Rancher Desktop はコンテナエンジンを dockerd (moby) にする）。

入ったかの確認

node -v            # v20.x
npm -v
pod --version
supabase --version
docker info > /dev/null && echo "docker OK"
psql --version
python3 --version
xcodebuild -version

04リポジトリを取得する

2 つのリポジトリを同じ親ディレクトリに並べて置きます（ソースコードのコメントが shushu-supabase/… のように相対で指しているため）。場所は自由です。

mkdir -p ~/dev/shushu && cd ~/dev/shushu
gh repo clone OkahashiKa/shushu-app
gh repo clone OkahashiKa/shushu-supabase
gh repo clone OkahashiKa/shushu-design   # 設計を読むなら

05Supabase をローカルで起動する

Docker が起動していることを確かめてから実行します。初回はイメージの取得で数分かかります。

cd ~/dev/shushu/shushu-supabase
supabase start

続けて、マイグレーションをすべて流し直し、図鑑マスタ（supabase/seed.sql）を入れます。

supabase db reset

アプリを触れる状態にするため、テストアカウント・投稿・フォロー関係を入れます。何度流しても同じ状態に戻ります。

python3 scripts/seed-test-data.py

ログインに使うメールアドレスとパスワードは次で表示できます（ローカル DB 専用のアカウントです）。

python3 scripts/seed-test-data.py --accounts

管理画面（Studio）は http://127.0.0.1:54323、送られたメールの確認画面は supabase status に出る Mailpit の URL で開けます。

06アプリの .env を作る

依存を入れて、ひな形から .env を作ります。.env は git に入りません。

cd ~/dev/shushu/shushu-app
npm ci
cp .env.example .env

ローカル Supabase の URL と公開鍵を確認します。

supabase status -o env --workdir ../shushu-supabase | grep -E '^(API_URL|PUBLISHABLE_KEY|ANON_KEY)='

.env を次のように書き換えます。鍵は上で出た PUBLISHABLE_KEY の値（sb_publishable_ で始まる。公開前提の鍵）を入れます。

EXPO_PUBLIC_SUPABASE_URL=http://127.0.0.1:54321
EXPO_PUBLIC_SUPABASE_ANON_KEY=<PUBLISHABLE_KEY の値>
EXPO_PUBLIC_APP_ENV=development
EXPO_PUBLIC_ENABLE_OAUTH=false

07iOS シミュレータで動かす

初回: 開発用ビルドを作って入れる

ios/ ディレクトリは git に入っていません。次のコマンドが app.config.js から ios/ を生成し（prebuild）、CocoaPods を入れ、ビルドしてシミュレータに入れ、Metro を起動します。初回は 10 分以上かかります。

APP_VARIANT=development npx expo run:ios

使うシミュレータを選びたいときは --device を付けると一覧から選べます。

APP_VARIANT=development npx expo run:ios --device

シミュレータに「shushu (Dev)」が立ち上がったら、tester@shushu.test と --accounts で出たパスワードでログインします。ホームに投稿が並び、図鑑に記録済みの銘柄があれば成功です。

2 回目以降: JS だけの変更

アプリはシミュレータに入ったままなので、Metro を起動してアプリを開くだけです。

npx expo start --dev-client

Metro の画面で i を押すとシミュレータでアプリが開きます。ファイルを保存すると画面に反映されます。

ビルドし直しが要るとき

• package.json にネイティブのモジュールが増えた・変わった
• app.config.js（権限の文言・プラグイン・Bundle ID など）が変わった

git pull
npm ci
APP_VARIANT=development npx expo run:ios

.env を変えたときは、Metro をキャッシュを消して起動し直します。

npx expo start --dev-client --clear

08iPhone 実機で動かす（任意）

シミュレータで足りない確認（カメラ・位置情報・触ったときの感触・プッシュ通知）をするときだけです。

1. Mac の LAN の IP を .env に入れる

iPhone から見た 127.0.0.1 は iPhone 自身なので、Mac のローカル Supabase に届きません。Mac と iPhone を同じ Wi-Fi に繋ぎ、Mac の IP を調べて .env の URL を書き換えます（シミュレータもこの IP のまま動きます）。

ipconfig getifaddr en0

EXPO_PUBLIC_SUPABASE_URL=http://<上で出た IP>:54321

Wi-Fi の割り当てが変わると繋がらなくなります。そのときは IP を取り直して書き換え、Metro を --clear で起動し直してください。

2. 署名のチームを設定してビルドする

1. iPhone を USB で Mac に繋ぎ、iPhone の「設定 → プライバシーとセキュリティ → デベロッパモード」をオンにする
2. Xcode の Settings → Accounts に自分の Apple ID を追加する（実機への署名に使う）
3. 次のコマンドで実機を選んでビルドする。署名のチームを聞かれたら、参加している Apple Developer のチームを選ぶ

APP_VARIANT=development npx expo run:ios --device

初回起動時に「ローカルネットワーク上のデバイスの検索と接続」の許可を求められたら許可してください。許可しないと、エラーを出さずに接続が失敗します。

プッシュ通知を確かめるとき

開発用ビルドは、既定でプッシュ通知の権限（aps-environment）を外してあります。Apple Developer Program に加入していない個人チームの署名では、この権限があるとビルドが署名で落ちるためです（app.config.js）。Apple Developer のチームに参加していて通知を確かめるときだけ、次のように付けてビルドします。

APP_VARIANT=development IOS_PUSH_ENABLED=1 npx expo run:ios --device

09Android（任意・未検証）

アプリは Android にも対応していますが、既存メンバーの Mac には Android SDK が入っておらず、この手順でのローカル実行は確認していません。試す場合の入口だけ書きます。

1. Android Studio を入れ、SDK と Android エミュレータ（AVD）を 1 台作る
2. Android Studio 付属の JDK を使うよう JAVA_HOME と ANDROID_HOME を設定する
3. エミュレータから見た Mac は 10.0.2.2 なので、.env の URL を http://10.0.2.2:54321 か、Mac の LAN の IP にする

export JAVA_HOME="/Applications/Android Studio.app/Contents/jbr/Contents/Home"
export ANDROID_HOME="$HOME/Library/Android/sdk"
export PATH="$ANDROID_HOME/platform-tools:$ANDROID_HOME/emulator:$PATH"

APP_VARIANT=development npx expo run:android

動いた・つまずいた結果は共有してください。この章を書き直します。

10コミット前の確認

GitHub Actions（CI）と同じ確認を手元で流せます。

アプリ（shushu-app）

npx tsc --noEmit
npx expo lint --max-warnings 0
npx --yes expo-doctor@latest

バックエンド（shushu-supabase）

マイグレーションを足した・変えたときは、0 から流し直して通ることを確かめます。

supabase db reset
supabase db lint
python3 scripts/gen-seed.py --check

DB のテスト（SQL）は、ローカル DB に向けて流します。どれもトランザクションの中で作って ROLLBACK で終わるので、DB に何も残りません。合格の値は各ファイルの先頭のコメントにあります。

for f in supabase/tests/[!_]*.sql; do
  echo "== $f"
  PGPASSWORD=postgres psql -h 127.0.0.1 -p 54322 -U postgres -d postgres -v ON_ERROR_STOP=1 -Atqf "$f" || break
done

変更するときの決まり

• 図鑑マスタは supabase/seed-data/*.json が正本。JSON を直したら python3 scripts/gen-seed.py で seed.sql を作り直して一緒にコミットする（CI が一致を確かめる）
• 投稿の味のチップ・属性チップの許す値は、DB の CHECK とアプリの src/constants/tags.ts を同じ並びにする。片方だけ増やすと投稿が DB で弾かれる
• 行動分析のイベント名・プロパティは、DB の台帳（analytics.event_types）とアプリの src/constants/analytics.ts を同じコミットで変える
• 詳しい設計は shushu-supabase/README.md と shushu-design リポジトリ

11毎日の起動と停止

始めるとき

cd ~/dev/shushu/shushu-supabase && supabase start
cd ~/dev/shushu/shushu-app && npx expo start --dev-client

終わるとき

Metro は Ctrl+C で止めます。ターミナルを閉じるだけだと Metro が裏に残り、CPU を使い続けて Mac が熱くなることがあります（既存メンバーの Mac で、誰も見ていない Metro が 12 時間近く動き続けていた実例あり）。

cd ~/dev/shushu/shushu-supabase && supabase stop

裏に Metro が残っていないかの確認:

pgrep -fl "expo start"

他の人の変更を取り込むとき

cd ~/dev/shushu/shushu-supabase && git pull && supabase db reset && python3 scripts/seed-test-data.py
cd ~/dev/shushu/shushu-app && git pull && npm ci

shushu-app の package.json や app.config.js が変わっていたら、開発用ビルドを作り直してください。

12困ったとき

13確認したこと