ShopifyテーマをClaude CodeやAntigravityを使ってカスタマイズするシーンは、この1年でずいぶん増えてきたと思う。しかし一方でAIにコードを書いてもらい、テーマエディタにコピペして貼り付けて……という作業を繰り返している人も多いと思うが、それだと結局手間はあまり減っていない。より自動化し、安全かつ楽にできるように、今回はテーマ管理そのものをGitHubで自動化する方法について解説したいと思う。
まずShopifyとGitHubをつなぐところから
手順はシンプルだ。
GitHubでリポジトリを作成し、現在のテーマファイルをpushしておく
Shopify管理画面から「オンラインストア」→「テーマ」→「テーマを追加」→「GitHubから接続する」を選択する
GitHubにログインして、連携したいリポジトリとブランチを選んで「接続」を押す
テーマライブラリにGitHubのアイコン付きでテーマが追加されれば完了
⚠️ 開発ストアを作ったばかりの場合、初回ログイン直後はGitHub連携ができないことがある。一度ログアウトしてパートナーダッシュボードから再ログインすれば解消されるので、もし詰まったらそこを疑ってみてほしい。
本番とstagingを分けるメリット
GitHubでテーマを管理するとき、ブランチを本番(main)と検証(staging)に分けるやり方がよく使われる。なぜ分けるのか。
まず、本番環境に直接手を入れないで済む。「ちょっとした修正のつもりが、ストア全体が崩れた」という事故は、直接触っているから起きる。stagingで確認してからmainに反映するフローにするだけで、こういったリスクがほぼなくなる。stagingのプレビューURLを発行すれば、クライアントに「こんな感じです」と実際のブラウザで確認してもらえる。コードの変更履歴も残るので、「いつ・誰が・何を変えたか」が後から追いやすくなる点も地味に助かる。
ブランチとテーマの対応
`main` → 公開中のLive Theme(本番)
`staging` → 非公開のStaging Theme(検証用)
stagingテーマは「GitHubから接続する」で追加するとき、stagingブランチを指定すれば作れる。テーマ名に `[Staging]` などのプレフィックスをつけておくと、運用中に本番と混同しなくて済む。
ただShopify特有の注意点がある
一般的なWebアプリのGitフローをそのまま持ち込むと、少し勝手が違うので戸惑うかもしれない。理由はシンプルで、ShopifyのGitHub連携は双方向同期だから。エンジニアがコードをpushすれば当然テーマに反映されるが、逆に管理画面でテーマエディタを触ると、その変更が自動でGitHubにコミットされる。
この挙動を理解せずに運用を始めると、「マーチャントの担当者が丁寧に作ったコンテンツが、制作担当や制作会社のマージで消えた」という事態になる。これはよくある話で、双方の作業が無駄になる可能性があるので絶対に避けたいところ。

開発からリリースまでの流れ
まず開発を始める前に、mainを最新に引っ張ってくる。これが最初のルールだ。なぜかというと、開発中もマーチャント側が管理画面でテキストやレイアウトを変えている可能性があるから。その変更は `config/settings_data.json` などに記録されてmainに自動コミットされている。古い状態のまま開発をスタートすると、後のマージで本番の設定を上書きすることになる。
`main` をpullして最新化
mainをstagingにマージして同期
staging上でClaude Code / Antigravityで作業・コミット・プッシュ
Staging ThemeのプレビューURLでQA(ブラウザ上で実際に確認)
Backport(逆マージ) ← ★重要
staging → mainへPRを作成・マージ → Live Themeが自動更新されてリリース完了

運用で徹底すべきこと「Backport」
技術よりも、むしろここが肝。
stagingをmainにマージする前に、必ずmainをstagingに逆マージする。これをBackportと呼ぶ。やらないと、管理画面側でされた設定変更(テキスト修正やバナー更新など)を、古いstagingの状態で上書きしてしまう。地味な手順だが、事故防止に直結する。
BackportのやりかたーGitHubのWeb画面だけでOK
GitHubのリポジトリページで「Pull requests」→「New pull request」をクリック
base(マージ先)をstagingに、compare(マージ元)をmainに設定する。これが「逆向きPR」のポイント
「Create pull request」でPRを作成し、そのまま「Merge pull request」→「Confirm merge」で完了
⚠️ コンフリクトが起きた場合、GitHubがPR画面上で「Resolve conflicts」ボタンを表示してくれる。クリックするとブラウザ上のエディタが開くので、`config/settings_data.json` や `templates/*.json` の競合箇所を確認して、どちらを残すか選んで保存すればOKだ。コマンドラインは一切不要。
それから `main` と `staging` への直接pushは禁止にする。GitHubのBranch protection rulesで設定できる。Pull Requestを必ず経由するルールにしておけば、「誰が何をマージしたか」の履歴が残るし、レビューの機会も自然に生まれる。
このフローを一度整備してしまえば、AIを使ってカスタマイズしても安心して開発できるし、マーチャントの担当者もテーマエディタを遠慮なく使える。お互いが「相手の変更を壊さないか」を気にしながら作業しなくていい状態を作ることが、Shopify開発における本当の効率化だと思う。
