climaybe 3.2.0 → 3.3.0

package/README.md

@@ -94,7 +94,11 @@ Switch your local dev environment to a specific store (multi-store only).
 npx climaybe switch voldt-norway
 ```
 
-Copies `stores/<alias>/` JSON files to the repo root so you can preview that store locally, and sets `default_store` in `climaybe.config.json` so `climaybe serve` / `shopify theme dev` targets that store. If your current git branch is `staging-<alias>` or `live-<alias>`, `climaybe serve` uses that store’s domain from config (even if `default_store` differs), matching CI preview behavior.
+Copies `stores/<alias>/` JSON files to the repo root so you can preview that store locally, and sets `default_store` in `climaybe.config.json` so `climaybe serve` / `shopify theme dev` targets that store. If your current git branch is `staging-<alias>` or `live-<alias>`, `climaybe serve` still passes that branch’s store to Shopify for `--store` (even if `default_store` differs), matching CI preview behavior.
+
+### `climaybe serve` / `climaybe theme serve`
+
+Runs Tailwind/scripts/schema watchers and `shopify theme dev` (see the theme dev kit section for flags). In **multi-store** mode, the first step asks **which store to serve** (interactive terminal); the default choice is the store matching `default_store` (same as after `climaybe switch`). If you pick a **different** store, the CLI saves the current root `config/`, `templates/`, and `sections/` JSON files into `stores/<previous-alias>/` (same paths as `climaybe sync`), then copies the selected store’s JSONs to the root and updates `default_store`, so work in progress is not lost. In **CI** or when **stdin is not a TTY**, there is no prompt: it uses `default_store` unless you set **`CLIMAYBE_SERVE_STORE=<alias>`** to a configured alias.
 
 ### `climaybe sync [alias]` / `climaybe theme sync`
 
@@ -227,12 +231,14 @@ Enabled via `climaybe init` prompt (`Enable preview + cleanup workflows?`; defau
 
 | Workflow | Trigger | What it does |
 |----------|---------|-------------|
-| `pr-update.yml` | PR opened/synchronize/reopened (base: main, staging, develop, staging-*, live-*) | Shares draft theme, renames with `-PR<number>`, comments preview + customize URLs; uses default store for main/staging/develop, or the store for staging-&lt;alias&gt;/live-&lt;alias&gt;. **Path filter:** runs only when the PR changes theme paths (`assets/`, `blocks/`, `config/`, `layout/`, `locales/`, `sections/`, `snippets/`, `templates/`, `_scripts/`, `_styles/`, `shopify.theme.toml`, `stores/**`); docs-only or tooling-only PRs skip preview work. |
-| `pr-close.yml` | PR closed (same branch set) | Deletes matching preview themes and comments deleted count + names |
-| `reusable-share-theme.yml` | workflow_call | Shares Shopify draft theme and returns `theme_id` |
-| `reusable-rename-theme.yml` | workflow_call | Renames shared theme to include `PR<number>` (fails job on rename failure) |
-| `reusable-comment-on-pr.yml` | workflow_call | Posts preview comment including Customize URL |
-| `reusable-cleanup-themes.yml` | workflow_call | Deletes preview themes by PR number and exposes cleanup outputs |
+| `pr-update.yml` | PR opened/synchronize/reopened (base: main, staging, develop, staging-*, live-*) | Shares draft theme, renames with `-PR<number>`, comments preview + customize URLs. **Multi-store + base not** `staging-<alias>` **or** `live-<alias>`**:** publishes to **every** configured store (matrix) and posts **all** links in one PR comment. For `staging-<alias>` / `live-<alias>` bases, only that store is used. **Path filter:** theme paths only (`assets/`, `blocks/`, `config/`, `layout/`, `locales/`, `sections/`, `snippets/`, `templates/`, `_scripts/`, `_styles/`, `shopify.theme.toml`, `stores/**`). |
+| `pr-close.yml` | PR closed (same branch set) | Deletes this PR’s preview themes using the **same store matrix rule** as `pr-update`; PR comment shows **total** deleted count across stores. |
+| `cleanup-orphan-preview-themes.yml` | Weekly (Mon 06:00 UTC) + `workflow_dispatch` | Per store: deletes themes ending with `-PR<n>` when PR `#n` is **not** open (merged/closed without cleanup). Uses `gh pr list` (limit 1000 open PRs). |
+| `reusable-publish-pr-preview-store.yml` | workflow_call | Share + rename + upload comment fragment for **one** store (matrix leg in `pr-update`). |
+| `reusable-share-theme.yml` | workflow_call | Shares Shopify draft theme and returns `theme_id` (still available if you call it elsewhere) |
+| `reusable-rename-theme.yml` | workflow_call | Renames shared theme to include `PR<number>` (still available for custom flows) |
+| `reusable-comment-on-pr.yml` | workflow_call | Posts preview comment; aggregates `preview-fragment-*` artifacts when `use_preview_fragments` is true |
+| `reusable-cleanup-themes.yml` | workflow_call | `cleanup_mode: by_pr` deletes names ending with `-PR{padded}`; `orphan_pr` deletes `-PR<n>` when PR `n` is not open. Optional `result_artifact_prefix` for matrix fan-in on `pr-close` |
 | `reusable-extract-pr-number.yml` | workflow_call | Extracts padded/unpadded PR number outputs for naming and API-safe usage |
 
 ### Optional build + Lighthouse package
@@ -374,7 +380,7 @@ Add the following secrets to your GitHub repository (or use **GitLab CI/CD varia
 
 **Store URL:** During `climaybe init` (or `add-store`), store URL secret(s) are set from your configured store domain(s); theme tokens are optional prompts.
 
-**Multi-store:** Per-store secrets `SHOPIFY_STORE_URL_<ALIAS>` and `SHOPIFY_THEME_ACCESS_TOKEN_<ALIAS>` — the URL is set from config; you must provide the theme token per store. `<ALIAS>` is uppercase with hyphens as underscores (e.g. `voldt-norway` → `SHOPIFY_STORE_URL_VOLDT_NORWAY`). Preview and cleanup: for PRs targeting **main**, **staging**, or **develop** the workflows use the **default store** (from `config.default_store` or first in `config.stores`); for PRs targeting **staging-&lt;alias&gt;** or **live-&lt;alias&gt;** they use that store’s credentials. Set either the plain `SHOPIFY_*` secrets or the `_<ALIAS>` pair for each store you use in preview.
+**Multi-store:** Per-store secrets `SHOPIFY_STORE_URL_<ALIAS>` and `SHOPIFY_THEME_ACCESS_TOKEN_<ALIAS>` — the URL is set from config; you must provide the theme token per store. `<ALIAS>` is uppercase with hyphens as underscores (e.g. `voldt-norway` → `SHOPIFY_STORE_URL_VOLDT_NORWAY`). **Preview:** for PRs targeting **staging-&lt;alias&gt;** or **live-&lt;alias&gt;** only that store is used. For **main**, **staging**, **develop**, or other bases with **multiple** stores in `climaybe.config.json`, **pr-update** publishes the preview theme to **every** store (each must have secrets); **pr-close** cleans that PR’s preview themes on **all** stores. For a **single** store in config, behavior matches the default-store case. Optional **cleanup-orphan-preview-themes** (weekly + manual) removes stale `-PR<n>` themes when PR `n` is no longer open.
 
 ## Directory Structure (Multi-store)
 

package/bin/version.txt

@@ -1 +1 @@
-3.2.0
+3.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "climaybe",
-  "version": "3.2.0",
+  "version": "3.3.0",
   "description": "Shopify CLI by Electric Maybe for theme CI/CD workflows, branch orchestration, app setup, and dev tooling",
   "type": "module",
   "bin": {

package/src/index.js

@@ -64,8 +64,12 @@ function registerThemeCommands(cmd) {
     .command('serve')
     .description('Run local theme dev (Shopify + assets; Theme Check off by default)')
     .option('--theme-check', 'Enable Theme Check watcher')
-    .action((opts) => serveAll({ includeThemeCheck: opts.themeCheck === true }));
-  cmd.command('serve:shopify').description('Run Shopify theme dev server').action(() => serveShopify());
+    .action(async (opts) => {
+      await serveAll({ includeThemeCheck: opts.themeCheck === true });
+    });
+  cmd.command('serve:shopify').description('Run Shopify theme dev server').action(async () => {
+    await serveShopify();
+  });
   cmd
     .command('serve:assets')
     .description('Run assets watch (Tailwind + scripts; Theme Check off by default)')

package/src/lib/config.js

@@ -180,6 +180,23 @@ export function getStoreAliases(cwd = process.cwd()) {
   return Object.keys(config.stores);
 }
 
+/**
+ * Resolve the store alias for `default_store` (the domain last set by `climaybe switch` or serve).
+ * @param {string} [cwd]
+ * @returns {string | null}
+ */
+export function getAliasForDefaultStore(cwd = process.cwd()) {
+  const config = readConfig(cwd);
+  const domain = config?.default_store;
+  const stores = config?.stores;
+  if (!domain || !stores || typeof stores !== 'object') return null;
+  const normalized = String(domain).trim();
+  for (const [alias, storeDomain] of Object.entries(stores)) {
+    if (String(storeDomain).trim() === normalized) return alias;
+  }
+  return null;
+}
+
 /**
  * Determine the current mode: 'single' or 'multi'.
  */

package/src/lib/dev-runtime.js

@@ -4,6 +4,7 @@ import { watchTree } from './watch.js';
 import { isAbsolute, join, relative } from 'node:path';
 import pc from 'picocolors';
 import { readConfig, getStoreDomainFromBranch } from './config.js';
+import { prepareMultiStoreForServe } from './serve-multi-store.js';
 import { buildScripts } from './build-scripts.js';
 import { buildSchemas } from './schema-builder.js';
 import { runShopify } from './shopify-cli.js';
@@ -209,7 +210,15 @@ function runThemeCheckFiltered({ cwd = process.cwd() } = {}) {
   return child;
 }
 
-export function serveShopify({ cwd = process.cwd() } = {}) {
+/**
+ * @param {{ cwd?: string; skipMultiStorePrep?: boolean }} [opts]
+ * @returns {Promise<import('node:child_process').ChildProcess | null>} Null when multi-store prep failed or was cancelled.
+ */
+export async function serveShopify({ cwd = process.cwd(), skipMultiStorePrep = false } = {}) {
+  if (!skipMultiStorePrep) {
+    const ok = await prepareMultiStoreForServe(cwd);
+    if (!ok) return null;
+  }
   const config = readConfig(cwd) || {};
   const branchStore = getStoreDomainFromBranch(cwd);
   const store = branchStore || config.default_store || config.store || '';
@@ -365,16 +374,28 @@ export function serveAssets({ cwd = process.cwd(), includeThemeCheck = false } =
   return { tailwind, devMcp, scriptsWatch, schemasWatch, themeCheckWatch, cleanup };
 }
 
-export function serveAll({ cwd = process.cwd(), includeThemeCheck = false } = {}) {
+export async function serveAll({ cwd = process.cwd(), includeThemeCheck = false } = {}) {
+  const prepOk = await prepareMultiStoreForServe(cwd);
+  if (!prepOk) {
+    const noop = () => {};
+    return { cleanup: noop };
+  }
+
   // Start assets first, then bring up Shopify after a short delay.
   const assets = serveAssets({ cwd, includeThemeCheck });
   let shopify = null;
   const shopifyStartDelayMs = 2500;
   const shopifyTimer = setTimeout(() => {
-    shopify = serveShopify({ cwd });
-    shopify.on('exit', () => {
-      cleanup();
-    });
+    void (async () => {
+      shopify = await serveShopify({ cwd, skipMultiStorePrep: true });
+      if (shopify) {
+        shopify.on('exit', () => {
+          cleanup();
+        });
+      } else {
+        cleanup();
+      }
+    })();
   }, shopifyStartDelayMs);
   console.log(pc.dim(`  Waiting ${shopifyStartDelayMs}ms before starting Shopify...`));
 

package/src/lib/prompts.js

@@ -229,6 +229,28 @@ export async function promptProjectName(cwd = process.cwd()) {
   return String(projectName || '').trim();
 }
 
+/**
+ * Ask which store to use for local theme dev (multi-store `climaybe serve`).
+ * @param {{ aliases: string[]; stores: Record<string, string>; suggestedAlias: string }} opts
+ * @returns {Promise<string | null>} Selected alias, or null if cancelled.
+ */
+export async function promptServeStore({ aliases, stores, suggestedAlias }) {
+  const sorted = [...aliases].sort();
+  const choices = sorted.map((alias) => ({
+    title: `${alias} (${stores[alias]})`,
+    value: alias,
+  }));
+  const initialIndex = sorted.indexOf(suggestedAlias);
+  const { alias } = await prompts({
+    type: 'select',
+    name: 'alias',
+    message: 'Which store should we serve?',
+    choices,
+    initial: initialIndex >= 0 ? initialIndex : 0,
+  });
+  return alias ?? null;
+}
+
 /**
  * Prompt for a single new store (used by add-store command).
  * Takes existing aliases to prevent duplicates.

package/src/lib/serve-multi-store.js

@@ -0,0 +1,81 @@
+import pc from 'picocolors';
+import { readConfig, getMode, getProjectType, getStoreAliases, writeConfig, getAliasForDefaultStore } from './config.js';
+import { rootToStores, storesToRoot } from './store-sync.js';
+import { promptServeStore } from './prompts.js';
+
+function readExplicitServeAlias(cwd) {
+  const raw = process.env.CLIMAYBE_SERVE_STORE?.trim();
+  if (!raw) return { ok: true, alias: null };
+  const aliases = getStoreAliases(cwd);
+  if (aliases.includes(raw)) return { ok: true, alias: raw };
+  console.log(pc.red(`  CLIMAYBE_SERVE_STORE="${raw}" is not a known store alias.`));
+  console.log(pc.dim(`  Available: ${aliases.join(', ')}\n`));
+  return { ok: false, alias: null };
+}
+
+function isNonInteractiveServe() {
+  if (process.env.CLIMAYBE_SERVE_STORE?.trim()) return true;
+  if (process.env.CI === 'true') return true;
+  return process.stdin.isTTY !== true;
+}
+
+/**
+ * In multi-store theme repos, ensure root JSONs and `default_store` match the store
+ * the user wants to serve. If the choice differs from the previous switch target,
+ * saves current root → `stores/<previous>/` then loads `stores/<selected>/` → root.
+ *
+ * @param {string} [cwd]
+ * @returns {Promise<boolean>} False if the user cancelled or `CLIMAYBE_SERVE_STORE` is invalid.
+ */
+export async function prepareMultiStoreForServe(cwd = process.cwd()) {
+  if (getProjectType(cwd) === 'app') return true;
+  if (getMode(cwd) !== 'multi') return true;
+
+  const config = readConfig(cwd);
+  if (!config?.stores || typeof config.stores !== 'object') return true;
+
+  const aliases = getStoreAliases(cwd);
+  if (aliases.length < 2) return true;
+
+  const stores = config.stores;
+  const suggestedAlias = getAliasForDefaultStore(cwd) ?? aliases[0];
+
+  const explicit = readExplicitServeAlias(cwd);
+  if (!explicit.ok) return false;
+
+  let selected = explicit.alias;
+  if (!selected) {
+    if (isNonInteractiveServe()) {
+      selected = suggestedAlias;
+    } else {
+      console.log(pc.bold('\n  climaybe — serve (store)\n'));
+      selected = await promptServeStore({ aliases, stores, suggestedAlias });
+      if (!selected) {
+        console.log(pc.dim('  Cancelled.\n'));
+        return false;
+      }
+    }
+  }
+
+  const previousAlias = getAliasForDefaultStore(cwd);
+
+  if (selected === previousAlias) return true;
+
+  if (previousAlias) {
+    rootToStores(previousAlias, cwd);
+  } else {
+    console.log(
+      pc.yellow(
+        '  Warning: default_store did not match any store alias; current root JSONs are not auto-saved to a store folder.'
+      )
+    );
+  }
+
+  const ok = storesToRoot(selected, cwd);
+  if (!ok) return false;
+
+  const domain = stores[selected];
+  if (domain) writeConfig({ default_store: domain }, cwd);
+
+  return true;
+}

package/src/workflows/preview/cleanup-orphan-preview-themes.yml

@@ -0,0 +1,59 @@
+# climaybe — Cleanup orphan preview themes (optional)
+# Weekly (and manual): on each configured store, delete themes whose name ends with -PR<n>
+# when PR #n is not open in this repo (merged/closed without theme cleanup).
+
+name: Cleanup orphan preview themes
+
+on:
+  schedule:
+    - cron: '0 6 * * 1'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pull-requests: read
+
+jobs:
+  configure:
+    runs-on: ubuntu-latest
+    outputs:
+      preview_targets_json: ${{ steps.cfg.outputs.preview_targets_json }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build store matrix from climaybe.config.json
+        id: cfg
+        run: |
+          if [ ! -f climaybe.config.json ]; then
+            {
+              echo 'preview_targets_json<<PT_JSON'
+              echo '[]'
+              echo 'PT_JSON'
+            } >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+          node <<'NODE' >>"$GITHUB_OUTPUT"
+          const fs = require('fs');
+          const cfg = JSON.parse(fs.readFileSync('climaybe.config.json', 'utf8'));
+          const stores = cfg?.stores || {};
+          const keys = Object.keys(stores);
+          const aliasToSecret = (a) => String(a).toUpperCase().replace(/-/g, '_');
+          const targets = keys.map((alias) => ({ alias, alias_secret: aliasToSecret(alias) }));
+          console.log('preview_targets_json<<PT_JSON');
+          console.log(JSON.stringify(targets));
+          console.log('PT_JSON');
+          NODE
+
+  cleanup-orphans:
+    needs: [configure]
+    if: needs.configure.outputs.preview_targets_json != '[]'
+    strategy:
+      fail-fast: false
+      matrix:
+        include: ${{ fromJson(needs.configure.outputs.preview_targets_json) }}
+    uses: ./.github/workflows/reusable-cleanup-themes.yml
+    with:
+      cleanup_mode: orphan_pr
+      pr_number: ''
+      store_alias_secret: ${{ matrix.alias_secret }}
+    secrets: inherit

package/src/workflows/preview/pr-close.yml

@@ -8,6 +8,10 @@ on:
     types: [closed]
     branches: [main, staging, develop, 'staging-*', 'live-*']
 
+permissions:
+  contents: read
+  pull-requests: write
+
 jobs:
   extract-pr-number:
     uses: ./.github/workflows/reusable-extract-pr-number.yml
@@ -15,73 +19,123 @@ jobs:
   resolve-store:
     runs-on: ubuntu-latest
     outputs:
-      store_alias: ${{ steps.resolve.outputs.alias }}
-      store_alias_secret: ${{ steps.resolve.outputs.alias_secret }}
+      store_alias: ${{ steps.resolve.outputs.store_alias }}
+      store_alias_secret: ${{ steps.resolve.outputs.store_alias_secret }}
+      preview_targets_json: ${{ steps.resolve.outputs.preview_targets_json }}
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
 
-      - name: Resolve store alias from base branch
+      - name: Resolve preview store targets from base branch
         id: resolve
         env:
           BASE_REF: ${{ github.event.pull_request.base.ref }}
         run: |
-          if [[ -n "$BASE_REF" && ("$BASE_REF" == staging-* || "$BASE_REF" == live-*) ]]; then
-            ALIAS="${BASE_REF#staging-}"
-            ALIAS="${ALIAS#live-}"
-          else
-            ALIAS=$(node -e "
-              const fs = require('fs');
-              const cfg = JSON.parse(fs.readFileSync('./climaybe.config.json', 'utf8'));
-              const stores = cfg?.stores || {};
-              const defaultStoreRaw = cfg?.default_store;
-              const normalize = (v) => String(v || '')
-                .toLowerCase()
-                .replace(/^https?:\\/\\//, '')
-                .replace(/\\/.*$/, '');
-              const defaultStore = normalize(defaultStoreRaw);
-              let alias = '';
-              if (defaultStore) {
-                for (const [k, d] of Object.entries(stores)) {
-                  if (normalize(d) === defaultStore) {
-                    alias = k;
-                    break;
-                  }
+          node <<'NODE' >>"$GITHUB_OUTPUT"
+          const fs = require('fs');
+          const cfg = JSON.parse(fs.readFileSync('climaybe.config.json', 'utf8'));
+          const stores = cfg?.stores || {};
+          const keys = Object.keys(stores);
+          const baseRef = process.env.BASE_REF || '';
+          const isMulti = keys.length > 1;
+          const isStagingLive =
+            baseRef && (/^staging-/.test(baseRef) || /^live-/.test(baseRef));
+
+          const aliasToSecret = (a) => String(a).toUpperCase().replace(/-/g, '_');
+          const normalizeDomain = (v) =>
+            String(v || '')
+              .toLowerCase()
+              .replace(/^https?:\/\//, '')
+              .replace(/\/.*$/, '');
+
+          let targets = [];
+          if (isMulti && !isStagingLive) {
+            targets = keys.map((alias) => ({ alias, alias_secret: aliasToSecret(alias) }));
+          } else if (isStagingLive) {
+            let a = baseRef.replace(/^staging-/, '').replace(/^live-/, '');
+            targets = [{ alias: a, alias_secret: aliasToSecret(a) }];
+          } else {
+            const defaultStoreNorm = normalizeDomain(cfg?.default_store);
+            let alias = '';
+            if (defaultStoreNorm) {
+              for (const [k, d] of Object.entries(stores)) {
+                if (normalizeDomain(d) === defaultStoreNorm) {
+                  alias = k;
+                  break;
                 }
               }
-              if (!alias) {
-                alias = Object.keys(stores)[0] || '';
-              }
-              if (!alias && defaultStore) {
-                const subdomain = defaultStore.split('.')[0] || 'default';
-                alias = subdomain.replace(/[^a-z0-9-]/g, '-').replace(/-+/g, '-') || 'default';
-              }
-              if (!alias) {
-                alias = 'default';
-              }
-              process.stdout.write(alias);
-            ")
-          fi
+            }
+            if (!alias) alias = keys[0] || '';
+            if (!alias && cfg?.default_store) {
+              const sub = normalizeDomain(cfg.default_store).split('.')[0] || 'default';
+              alias = sub.replace(/[^a-z0-9-]/g, '-').replace(/-+/g, '-') || 'default';
+            }
+            if (!alias) alias = 'default';
+            targets = [{ alias, alias_secret: aliasToSecret(alias) }];
+          }
 
-          if [ -z "$ALIAS" ]; then
-            echo "Could not resolve store alias from climaybe.config.json config or base branch."
-            exit 1
-          fi
+          if (targets.length === 0 || targets.some((t) => !t.alias)) {
+            console.error('Could not resolve store targets from climaybe.config.json');
+            process.exit(1);
+          }
 
-          ALIAS_SECRET=$(echo "$ALIAS" | tr '[:lower:]-' '[:upper:]_')
-          echo "alias=$ALIAS" >> $GITHUB_OUTPUT
-          echo "alias_secret=$ALIAS_SECRET" >> $GITHUB_OUTPUT
+          console.log('preview_targets_json<<PT_JSON');
+          console.log(JSON.stringify(targets));
+          console.log('PT_JSON');
+          console.log(`store_alias=${targets[0].alias}`);
+          console.log(`store_alias_secret=${targets[0].alias_secret}`);
+          NODE
 
   cleanup-theme:
     needs: [extract-pr-number, resolve-store]
+    strategy:
+      fail-fast: false
+      matrix:
+        include: ${{ fromJson(needs.resolve-store.outputs.preview_targets_json) }}
     uses: ./.github/workflows/reusable-cleanup-themes.yml
     with:
+      cleanup_mode: by_pr
       pr_number: ${{ needs.extract-pr-number.outputs.pr_number }}
-      store_alias_secret: ${{ needs.resolve-store.outputs.store_alias_secret }}
+      store_alias_secret: ${{ matrix.alias_secret }}
+      result_artifact_prefix: pr-close-cleanup
     secrets: inherit
 
+  cleanup-totals:
+    needs: [cleanup-theme]
+    if: always()
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+    outputs:
+      deleted_count: ${{ steps.sum.outputs.deleted_count }}
+    steps:
+      - name: Download cleanup result fragments
+        continue-on-error: true
+        uses: actions/download-artifact@v4
+        with:
+          pattern: pr-close-cleanup-*
+          merge-multiple: true
+          path: cleanup-counts
+
+      - name: Sum deleted themes across stores
+        id: sum
+        run: |
+          total=0
+          if [ -d cleanup-counts ]; then
+            while IFS= read -r -d '' f; do
+              [ -z "$f" ] && continue
+              [ ! -f "$f" ] && continue
+              n="$(tr -d ' \n\r' < "$f" 2>/dev/null || echo 0)"
+              n="${n:-0}"
+              total=$((total + n))
+            done < <(find cleanup-counts -name 'deleted-count.txt' -type f -print0 2>/dev/null || true)
+          fi
+          echo "deleted_count=$total" >> "$GITHUB_OUTPUT"
+          echo "Total deleted across stores: $total"
+
   comment-on-pr:
-    needs: [cleanup-theme, resolve-store]
+    needs: [cleanup-totals, resolve-store]
+    if: always()
     runs-on: ubuntu-latest
     steps:
       - name: Comment on PR about cleanup
@@ -90,8 +144,7 @@ jobs:
           script: |
             const prNumber = context.payload.pull_request.number;
             const storeAlias = '${{ needs.resolve-store.outputs.store_alias }}' || '';
-            const deletedCount = parseInt('${{ needs.cleanup-theme.outputs.deleted_count }}') || 0;
-            const deletedThemesRaw = `${{ needs.cleanup-theme.outputs.deleted_themes }}`.trim();
+            const deletedCount = parseInt('${{ needs.cleanup-totals.outputs.deleted_count }}') || 0;
 
             const lines = [
               '## 🧹 Theme Cleanup Complete',
@@ -100,22 +153,10 @@ jobs:
               '',
               `**Branch:** ${context.payload.pull_request.head.ref}`,
               `**PR Status:** ${context.payload.pull_request.state}`,
-              storeAlias ? `**Store:** ${storeAlias}` : null,
-              `**Deleted Themes:** ${deletedCount}`
+              storeAlias ? `**Primary store (config):** ${storeAlias}` : null,
+              `**Deleted themes (all preview stores):** ${deletedCount}`
             ].filter(Boolean);
 
-            if (deletedCount > 0 && deletedThemesRaw) {
-              const deletedThemeLines = deletedThemesRaw
-                .split('\n')
-                .map(name => name.trim())
-                .filter(Boolean)
-                .map(name => `- ${name}`);
-
-              if (deletedThemeLines.length > 0) {
-                lines.push('', '### Deleted Theme Names', ...deletedThemeLines);
-              }
-            }
-
             lines.push('', '---', '*Theme cleanup runs automatically when a PR is closed.*');
 
             await github.rest.issues.createComment({

package/src/workflows/preview/pr-update.yml

@@ -44,119 +44,130 @@ jobs:
     if: needs.filter.outputs.theme == 'true'
     runs-on: ubuntu-latest
     outputs:
-      store_alias: ${{ steps.resolve.outputs.alias }}
-      store_alias_secret: ${{ steps.resolve.outputs.alias_secret }}
+      store_alias: ${{ steps.resolve.outputs.store_alias }}
+      store_alias_secret: ${{ steps.resolve.outputs.store_alias_secret }}
+      preview_targets_json: ${{ steps.resolve.outputs.preview_targets_json }}
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
 
-      - name: Resolve store alias from base branch
+      - name: Resolve preview store targets from base branch
         id: resolve
         env:
           BASE_REF: ${{ github.event.pull_request.base.ref }}
         run: |
-          # On staging-<alias> or live-<alias> PRs, use that store; otherwise default store
-          if [[ -n "$BASE_REF" && ("$BASE_REF" == staging-* || "$BASE_REF" == live-*) ]]; then
-            ALIAS="${BASE_REF#staging-}"
-            ALIAS="${ALIAS#live-}"
-          else
-            ALIAS=$(node -e "
-              const fs = require('fs');
-              const cfg = JSON.parse(fs.readFileSync('./climaybe.config.json', 'utf8'));
-              const stores = cfg?.stores || {};
-              const defaultStoreRaw = cfg?.default_store;
-              const normalize = (v) => String(v || '')
-                .toLowerCase()
-                .replace(/^https?:\\/\\//, '')
-                .replace(/\\/.*$/, '');
-              const defaultStore = normalize(defaultStoreRaw);
-              let alias = '';
-              if (defaultStore) {
-                for (const [k, d] of Object.entries(stores)) {
-                  if (normalize(d) === defaultStore) {
-                    alias = k;
-                    break;
-                  }
+          node <<'NODE' >>"$GITHUB_OUTPUT"
+          const fs = require('fs');
+          const cfg = JSON.parse(fs.readFileSync('climaybe.config.json', 'utf8'));
+          const stores = cfg?.stores || {};
+          const keys = Object.keys(stores);
+          const baseRef = process.env.BASE_REF || '';
+          const isMulti = keys.length > 1;
+          const isStagingLive =
+            baseRef && (/^staging-/.test(baseRef) || /^live-/.test(baseRef));
+
+          const aliasToSecret = (a) => String(a).toUpperCase().replace(/-/g, '_');
+          const normalizeDomain = (v) =>
+            String(v || '')
+              .toLowerCase()
+              .replace(/^https?:\/\//, '')
+              .replace(/\/.*$/, '');
+
+          let targets = [];
+          if (isMulti && !isStagingLive) {
+            targets = keys.map((alias) => ({ alias, alias_secret: aliasToSecret(alias) }));
+          } else if (isStagingLive) {
+            let a = baseRef.replace(/^staging-/, '').replace(/^live-/, '');
+            targets = [{ alias: a, alias_secret: aliasToSecret(a) }];
+          } else {
+            const defaultStoreNorm = normalizeDomain(cfg?.default_store);
+            let alias = '';
+            if (defaultStoreNorm) {
+              for (const [k, d] of Object.entries(stores)) {
+                if (normalizeDomain(d) === defaultStoreNorm) {
+                  alias = k;
+                  break;
                 }
               }
-              if (!alias) {
-                alias = Object.keys(stores)[0] || '';
-              }
-              if (!alias && defaultStore) {
-                const subdomain = defaultStore.split('.')[0] || 'default';
-                alias = subdomain.replace(/[^a-z0-9-]/g, '-').replace(/-+/g, '-') || 'default';
-              }
-              if (!alias) {
-                alias = 'default';
-              }
-              process.stdout.write(alias);
-            ")
-          fi
+            }
+            if (!alias) alias = keys[0] || '';
+            if (!alias && cfg?.default_store) {
+              const sub = normalizeDomain(cfg.default_store).split('.')[0] || 'default';
+              alias = sub.replace(/[^a-z0-9-]/g, '-').replace(/-+/g, '-') || 'default';
+            }
+            if (!alias) alias = 'default';
+            targets = [{ alias, alias_secret: aliasToSecret(alias) }];
+          }
 
-          if [ -z "$ALIAS" ]; then
-            echo "Could not resolve default store alias from climaybe.config.json config."
-            exit 1
-          fi
+          if (targets.length === 0 || targets.some((t) => !t.alias)) {
+            console.error('Could not resolve store targets from climaybe.config.json');
+            process.exit(1);
+          }
 
-          ALIAS_SECRET=$(echo "$ALIAS" | tr '[:lower:]-' '[:upper:]_')
-          echo "alias=$ALIAS" >> $GITHUB_OUTPUT
-          echo "alias_secret=$ALIAS_SECRET" >> $GITHUB_OUTPUT
+          console.log('preview_targets_json<<PT_JSON');
+          console.log(JSON.stringify(targets));
+          console.log('PT_JSON');
+          console.log(`store_alias=${targets[0].alias}`);
+          console.log(`store_alias_secret=${targets[0].alias_secret}`);
+          NODE
 
-      - name: Validate Shopify credentials
+  validate-secrets-per-store:
+    needs: [validate-environment]
+    strategy:
+      fail-fast: false
+      matrix:
+        include: ${{ fromJson(needs.validate-environment.outputs.preview_targets_json) }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Require Shopify URL + theme token for this store
         env:
-          SHOPIFY_STORE_URL_SCOPED: ${{ secrets[format('SHOPIFY_STORE_URL_{0}', steps.resolve.outputs.alias_secret)] }}
-          SHOPIFY_THEME_ACCESS_TOKEN_SCOPED: ${{ secrets[format('SHOPIFY_THEME_ACCESS_TOKEN_{0}', steps.resolve.outputs.alias_secret)] }}
+          SHOPIFY_STORE_URL_SCOPED: ${{ secrets[format('SHOPIFY_STORE_URL_{0}', matrix.alias_secret)] }}
+          SHOPIFY_THEME_ACCESS_TOKEN_SCOPED: ${{ secrets[format('SHOPIFY_THEME_ACCESS_TOKEN_{0}', matrix.alias_secret)] }}
           SHOPIFY_STORE_URL_DEFAULT: ${{ secrets.SHOPIFY_STORE_URL }}
           SHOPIFY_THEME_ACCESS_TOKEN_DEFAULT: ${{ secrets.SHOPIFY_THEME_ACCESS_TOKEN }}
         run: |
           SHOPIFY_STORE_URL="${SHOPIFY_STORE_URL_SCOPED:-$SHOPIFY_STORE_URL_DEFAULT}"
           SHOPIFY_THEME_ACCESS_TOKEN="${SHOPIFY_THEME_ACCESS_TOKEN_SCOPED:-$SHOPIFY_THEME_ACCESS_TOKEN_DEFAULT}"
-
-          if [ -z "$SHOPIFY_STORE_URL" ]; then
-            echo "No store URL secret found. Expected SHOPIFY_STORE_URL_${{ steps.resolve.outputs.alias_secret }} or SHOPIFY_STORE_URL."
+          if [ -z "$SHOPIFY_STORE_URL" ] || [ -z "$SHOPIFY_THEME_ACCESS_TOKEN" ]; then
+            echo "Missing SHOPIFY_* for ${{ matrix.alias }} (secret suffix ${{ matrix.alias_secret }})."
             exit 1
           fi
-          if [ -z "$SHOPIFY_THEME_ACCESS_TOKEN" ]; then
-            echo "No theme token secret found. Expected SHOPIFY_THEME_ACCESS_TOKEN_${{ steps.resolve.outputs.alias_secret }} or SHOPIFY_THEME_ACCESS_TOKEN."
-            exit 1
-          fi
-          echo "Shopify credentials are configured for alias: ${{ steps.resolve.outputs.alias }}"
+          echo "Shopify credentials OK for ${{ matrix.alias }}"
 
   cleanup-themes:
-    needs: [extract-pr-number, validate-environment]
+    needs: [extract-pr-number, validate-secrets-per-store]
+    strategy:
+      fail-fast: false
+      matrix:
+        include: ${{ fromJson(needs.validate-environment.outputs.preview_targets_json) }}
     uses: ./.github/workflows/reusable-cleanup-themes.yml
     with:
+      cleanup_mode: by_pr
       pr_number: ${{ needs.extract-pr-number.outputs.pr_number }}
-      store_alias_secret: ${{ needs.validate-environment.outputs.store_alias_secret }}
+      store_alias_secret: ${{ matrix.alias_secret }}
     secrets: inherit
 
-  share-theme:
+  publish-preview-store:
     needs: [validate-environment, extract-pr-number, cleanup-themes]
-    uses: ./.github/workflows/reusable-share-theme.yml
+    strategy:
+      fail-fast: false
+      matrix:
+        include: ${{ fromJson(needs.validate-environment.outputs.preview_targets_json) }}
+    uses: ./.github/workflows/reusable-publish-pr-preview-store.yml
     with:
       pr_number: ${{ needs.extract-pr-number.outputs.pr_number }}
-      store_alias: ${{ needs.validate-environment.outputs.store_alias }}
-      store_alias_secret: ${{ needs.validate-environment.outputs.store_alias_secret }}
-    secrets: inherit
-
-  rename-theme:
-    needs: [share-theme, extract-pr-number, validate-environment]
-    uses: ./.github/workflows/reusable-rename-theme.yml
-    with:
-      theme_id: ${{ needs.share-theme.outputs.theme_id }}
-      theme_name: ${{ needs.share-theme.outputs.theme_name }}
-      pr_number: ${{ needs.extract-pr-number.outputs.pr_number }}
-      store_alias: ${{ needs.validate-environment.outputs.store_alias }}
-      store_alias_secret: ${{ needs.validate-environment.outputs.store_alias_secret }}
+      store_alias: ${{ matrix.alias }}
+      store_alias_secret: ${{ matrix.alias_secret }}
     secrets: inherit
 
   comment-on-pr:
-    needs: [share-theme, rename-theme, extract-pr-number, validate-environment]
+    needs: [publish-preview-store, extract-pr-number, validate-environment]
     uses: ./.github/workflows/reusable-comment-on-pr.yml
     with:
-      theme_id: ${{ needs.share-theme.outputs.theme_id }}
-      share_output: ${{ needs.share-theme.outputs.share_output }}
+      theme_id: ${{ needs.publish-preview-store.outputs.theme_id }}
+      share_output: ${{ needs.publish-preview-store.outputs.share_output }}
       pr_number: ${{ needs.extract-pr-number.outputs.pr_number_unpadded }}
       store_alias: ${{ needs.validate-environment.outputs.store_alias }}
       store_alias_secret: ${{ needs.validate-environment.outputs.store_alias_secret }}
+      use_preview_fragments: 'true'
     secrets: inherit

package/src/workflows/preview/reusable-cleanup-themes.yml

@@ -3,14 +3,25 @@ name: Cleanup Themes
 on:
   workflow_call:
     inputs:
+      cleanup_mode:
+        required: false
+        type: string
+        default: 'by_pr'
+        description: "by_pr: delete themes whose name ends with -PR{pr_number} (padded). orphan_pr: delete themes ending with -PR<n> when PR n is not open in this repo."
       pr_number:
-        required: true
+        required: false
         type: string
-        description: "PR number to clean up themes for"
+        default: ''
+        description: "Padded PR number (e.g. 09) when cleanup_mode is by_pr; ignored for orphan_pr."
       store_alias_secret:
         required: false
         type: string
         description: "Upper snake-case alias for scoped secret (e.g. VOLDT_STAGING). If set, uses SHOPIFY_*_<this>; else uses SHOPIFY_STORE_URL / SHOPIFY_THEME_ACCESS_TOKEN."
+      result_artifact_prefix:
+        required: false
+        type: string
+        default: ''
+        description: "When non-empty, uploads a tiny artifact named {prefix}-{store_alias_secret} with deleted_count for matrix fan-in."
     outputs:
       deleted_count:
         description: "Number of deleted themes"
@@ -34,6 +45,10 @@ on:
 jobs:
   cleanup:
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: read
+      actions: write
     outputs:
       deleted_count: ${{ steps.cleanup.outputs.deleted_count }}
       deleted_themes: ${{ steps.cleanup.outputs.deleted_themes }}
@@ -51,7 +66,10 @@ jobs:
           SHOPIFY_STORE_URL: ${{ inputs.store_alias_secret && secrets[format('SHOPIFY_STORE_URL_{0}', inputs.store_alias_secret)] || secrets.SHOPIFY_STORE_URL }}
           SHOPIFY_THEME_ACCESS_TOKEN: ${{ inputs.store_alias_secret && secrets[format('SHOPIFY_THEME_ACCESS_TOKEN_{0}', inputs.store_alias_secret)] || secrets.SHOPIFY_THEME_ACCESS_TOKEN }}
           PR_NUMBER: ${{ inputs.pr_number }}
+          CLEANUP_MODE: ${{ inputs.cleanup_mode }}
           STORE_ALIAS_SECRET: ${{ inputs.store_alias_secret }}
+          RESULT_ARTIFACT_PREFIX: ${{ inputs.result_artifact_prefix }}
+          GH_TOKEN: ${{ github.token }}
         run: |
           set -euo pipefail
 
@@ -62,11 +80,13 @@ jobs:
           {
             echo "### 🧹 Cleanup preview themes"
             echo ""
-            echo "- **PR**: \`${PR_NUMBER}\`"
+            echo "- **Mode**: \`${CLEANUP_MODE}\`"
+            echo "- **PR (by_pr mode)**: \`${PR_NUMBER:-<n/a>}\`"
             echo "- **Store alias secret**: \`${STORE_ALIAS_SECRET:-<default>}\`"
             echo "- **Store (host)**: \`${STORE_HOST:-<missing>}\`"
           } >> "$GITHUB_STEP_SUMMARY"
 
+          echo "CLEANUP_MODE=${CLEANUP_MODE}"
           echo "PR=${PR_NUMBER}"
           echo "Store alias secret=${STORE_ALIAS_SECRET:-<default>}"
           echo "Store host=${STORE_HOST:-<missing>}"
@@ -93,6 +113,11 @@ jobs:
             exit 0
           fi
 
+          if [ "$CLEANUP_MODE" = "by_pr" ] && [ -z "${PR_NUMBER:-}" ]; then
+            echo "cleanup_mode is by_pr but pr_number is empty."
+            exit 1
+          fi
+
           echo "store_hint=${STORE_HOST:-}" >> "$GITHUB_OUTPUT"
           echo "skipped_reason=" >> "$GITHUB_OUTPUT"
 
@@ -121,7 +146,6 @@ jobs:
             exit 1
           fi
 
-          # Defensive: if CLI returned empty, treat as an empty list (instead of jq failure).
           if [ ! -s "$THEME_LIST_JSON" ]; then
             echo "[]" > "$THEME_LIST_JSON"
           fi
@@ -134,11 +158,59 @@ jobs:
           DELETED_COUNT=0
           DELETED_THEMES=""
 
+          OPEN_PRS_FILE="$(mktemp)"
+          if [ "$CLEANUP_MODE" = "orphan_pr" ]; then
+            echo "Fetching open PR numbers (limit 1000)…"
+            if ! gh pr list --repo "${GITHUB_REPOSITORY}" --state open --limit 1000 --json number -q '.[].number' > "$OPEN_PRS_FILE" 2>/dev/null; then
+              echo "gh pr list failed; cannot determine open PRs safely. Skipping orphan cleanup."
+              {
+                echo ""
+                echo "#### Result"
+                echo "- **Skipped**: \`gh pr list\` failed (check \`pull-requests: read\` permission)"
+              } >> "$GITHUB_STEP_SUMMARY"
+              echo "skipped_reason=gh_pr_list_failed" >> "$GITHUB_OUTPUT"
+              echo "matched_count=0" >> "$GITHUB_OUTPUT"
+              echo "matched_themes<<MATCHED_EOF" >> "$GITHUB_OUTPUT"
+              echo "MATCHED_EOF" >> "$GITHUB_OUTPUT"
+              echo "deleted_count=0" >> "$GITHUB_OUTPUT"
+              echo "deleted_themes<<DELETED_EOF" >> "$GITHUB_OUTPUT"
+              echo "DELETED_EOF" >> "$GITHUB_OUTPUT"
+              rm -f "$THEME_LIST_ERR" "$THEME_LIST_JSON" "$OPEN_PRS_FILE"
+              exit 0
+            fi
+            echo "Open PR count (lines): $(wc -l < "$OPEN_PRS_FILE" | tr -d ' ')"
+          fi
+
+          should_delete_theme() {
+            local id="$1"
+            local name="$2"
+            local suffix=""
+            suffix="$(printf '%s' "$name" | sed -n 's/.*-PR\([0-9][0-9]*\)$/\1/p')"
+            if [ -z "$suffix" ]; then
+              return 1
+            fi
+            if [ "$CLEANUP_MODE" = "by_pr" ]; then
+              case "$name" in
+                *"-PR${PR_NUMBER}") return 0 ;;
+                *) return 1 ;;
+              esac
+            fi
+            if [ "$CLEANUP_MODE" = "orphan_pr" ]; then
+              local num=""
+              num=$((10#$suffix))
+              if grep -qx "$num" "$OPEN_PRS_FILE" 2>/dev/null; then
+                return 1
+              fi
+              return 0
+            fi
+            return 1
+          }
+
           while IFS=$'\t' read -r THEME_ID THEME_NAME; do
             [ -z "$THEME_ID" ] && continue
             [ -z "$THEME_NAME" ] && continue
 
-            if printf "%s" "$THEME_NAME" | grep -q "PR${PR_NUMBER}"; then
+            if should_delete_theme "$THEME_ID" "$THEME_NAME"; then
               MATCHED_COUNT=$((MATCHED_COUNT + 1))
               MATCHED_THEMES="${MATCHED_THEMES}${THEME_NAME}\n"
               echo "Matched: $THEME_NAME ($THEME_ID)"
@@ -164,7 +236,7 @@ jobs:
             echo ""
             echo "#### Result"
             echo "- **Total themes on store**: ${ALL_COUNT}"
-            echo "- **Matched (PR${PR_NUMBER})**: ${MATCHED_COUNT}"
+            echo "- **Matched**: ${MATCHED_COUNT}"
             echo "- **Deleted**: ${DELETED_COUNT}"
           } >> "$GITHUB_STEP_SUMMARY"
 
@@ -197,3 +269,16 @@ jobs:
             printf "%b" "$DELETED_THEMES"
             echo "DELETED_EOF"
           } >> "$GITHUB_OUTPUT"
+
+          rm -f "$THEME_LIST_ERR" "$THEME_LIST_JSON" "$OPEN_PRS_FILE"
+
+      - name: Upload deleted count for matrix fan-in
+        if: inputs.result_artifact_prefix != ''
+        run: printf '%s' '${{ steps.cleanup.outputs.deleted_count }}' > deleted-count.txt
+      - name: Save cleanup result artifact
+        if: inputs.result_artifact_prefix != ''
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ inputs.result_artifact_prefix }}-${{ inputs.store_alias_secret }}
+          path: deleted-count.txt
+          retention-days: 2

package/src/workflows/preview/reusable-comment-on-pr.yml

@@ -19,11 +19,29 @@ on:
         required: false
         type: string
         description: "Upper snake-case alias for scoped secret (e.g. VOLDT_STAGING). If set, uses SHOPIFY_STORE_URL_<this>; else uses SHOPIFY_STORE_URL."
+      use_preview_fragments:
+        required: false
+        type: string
+        default: 'false'
+        description: "When 'true', download preview-fragment-* artifacts (from publish matrix) and post one comment with all preview URLs."
 
 jobs:
   comment:
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      actions: read
+      pull-requests: write
     steps:
+      - name: Download preview fragments (multi-store / matrix publish)
+        if: inputs.use_preview_fragments == 'true'
+        continue-on-error: true
+        uses: actions/download-artifact@v4
+        with:
+          pattern: preview-fragment-*
+          merge-multiple: true
+          path: preview-fragments
+
       - name: Post preview comment
         uses: actions/github-script@v7
         env:
@@ -31,39 +49,85 @@ jobs:
           THEME_ID: ${{ inputs.theme_id }}
           SHARE_OUTPUT: ${{ inputs.share_output }}
           PR_NUMBER: ${{ inputs.pr_number }}
+          USE_PREVIEW_FRAGMENTS: ${{ inputs.use_preview_fragments }}
         with:
           script: |
+            const fs = require('fs');
+            const path = require('path');
             const issueNumber = parseInt(process.env.PR_NUMBER);
-            const storeDomain = (process.env.SHOPIFY_STORE_URL || '')
-              .replace(/^https?:\/\//, '')
-              .replace(/\/$/, '');
-            const themeId = process.env.THEME_ID || '';
-            const shareOutput = process.env.SHARE_OUTPUT || '';
+            const useFragments = process.env.USE_PREVIEW_FRAGMENTS === 'true';
 
-            let previewUrl = '';
-            let customizeUrl = '';
-            if (storeDomain && themeId) {
-              previewUrl = `https://${storeDomain}?preview_theme_id=${themeId}`;
-              customizeUrl = `https://${storeDomain}/admin/themes/${themeId}/editor`;
+            const walkJsonFiles = (dir) => {
+              const out = [];
+              if (!fs.existsSync(dir)) return out;
+              const stack = [dir];
+              while (stack.length) {
+                const d = stack.pop();
+                for (const ent of fs.readdirSync(d, { withFileTypes: true })) {
+                  const p = path.join(d, ent.name);
+                  if (ent.isDirectory()) stack.push(p);
+                  else if (ent.name === 'fragment.json' || ent.name.endsWith('.json')) {
+                    try {
+                      out.push(JSON.parse(fs.readFileSync(p, 'utf8')));
+                    } catch {
+                      // ignore
+                    }
+                  }
+                }
+              }
+              return out;
+            };
+
+            let fragments = [];
+            if (useFragments) {
+              fragments = walkJsonFiles('preview-fragments');
             }
 
             const parts = [
               '## 🎨 Theme Preview Generated',
               '',
-              `**Store:** ${process.env.SHOPIFY_STORE_URL || 'N/A'}`,
               `**Branch:** ${context.payload.pull_request?.head?.ref || context.ref.replace('refs/heads/', '')}`,
               `**Commit:** ${(context.payload.pull_request?.head?.sha || context.sha || '').substring(0, 7)}`
             ];
 
-            if (customizeUrl) {
-              parts.push('', `**Customize URL:** ${customizeUrl}`);
-            }
-            if (previewUrl) {
-              parts.push('', `**Preview URL:** ${previewUrl}`);
-            }
-            if (shareOutput.trim()) {
-              parts.push('', '### Share Output', '```', shareOutput, '```');
+            if (fragments.length > 0) {
+              parts.push('', '### Preview links (per store)');
+              const byAlias = [...fragments].sort((a, b) => String(a.alias).localeCompare(String(b.alias)));
+              for (const f of byAlias) {
+                const host = (f.store_host || '').replace(/\/$/, '');
+                const tid = f.theme_id || '';
+                const alias = f.alias || 'store';
+                if (host && tid) {
+                  const previewUrl = `https://${host}?preview_theme_id=${tid}`;
+                  const customizeUrl = `https://${host}/admin/themes/${tid}/editor`;
+                  parts.push('', `**${alias}**`, `- Customize: ${customizeUrl}`, `- Preview: ${previewUrl}`);
+                }
+              }
+            } else if (useFragments) {
+              parts.push(
+                '',
+                '*(Could not load per-store preview fragments from workflow artifacts; see the publish job logs.)*'
+              );
+            } else {
+              const storeDomain = (process.env.SHOPIFY_STORE_URL || '')
+                .replace(/^https?:\/\//, '')
+                .replace(/\/$/, '');
+              const themeId = process.env.THEME_ID || '';
+              const shareOutput = process.env.SHARE_OUTPUT || '';
+              parts.push('', `**Store:** ${process.env.SHOPIFY_STORE_URL || 'N/A'}`);
+              let previewUrl = '';
+              let customizeUrl = '';
+              if (storeDomain && themeId) {
+                previewUrl = `https://${storeDomain}?preview_theme_id=${themeId}`;
+                customizeUrl = `https://${storeDomain}/admin/themes/${themeId}/editor`;
+              }
+              if (customizeUrl) parts.push('', `**Customize URL:** ${customizeUrl}`);
+              if (previewUrl) parts.push('', `**Preview URL:** ${previewUrl}`);
+              if (shareOutput.trim()) {
+                parts.push('', '### Share Output', '```', shareOutput, '```');
+              }
             }
+
             parts.push('', '---', '*This preview will be available for 7 days.*');
 
             await github.rest.issues.createComment({

package/src/workflows/preview/reusable-publish-pr-preview-store.yml

@@ -0,0 +1,162 @@
+# Share theme to one Shopify store, rename with -PR{padded}, upload JSON fragment for PR comment fan-in.
+# Intended to be called from a matrix job (one invocation per store).
+
+name: Publish PR preview (single store)
+
+on:
+  workflow_call:
+    inputs:
+      pr_number:
+        required: true
+        type: string
+        description: "Padded PR number (e.g. 09) for theme name suffix -PR09"
+      store_alias:
+        required: true
+        type: string
+        description: "Store alias (for artifact naming and comment JSON)"
+      store_alias_secret:
+        required: false
+        type: string
+        default: ''
+        description: "Upper snake-case secret suffix; empty uses SHOPIFY_STORE_URL / SHOPIFY_THEME_ACCESS_TOKEN"
+    outputs:
+      theme_id:
+        description: "Theme ID after share/rename"
+        value: ${{ jobs.publish.outputs.theme_id }}
+      theme_name:
+        description: "Final theme name after rename"
+        value: ${{ jobs.publish.outputs.theme_name }}
+      share_output:
+        description: "Raw share command output"
+        value: ${{ jobs.publish.outputs.share_output }}
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      actions: write
+    outputs:
+      theme_id: ${{ steps.rename.outputs.theme_id }}
+      theme_name: ${{ steps.rename.outputs.theme_name }}
+      share_output: ${{ steps.share.outputs.share_output }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Validate theme root
+        run: |
+          if [ ! -f "layout/theme.liquid" ]; then
+            echo "layout/theme.liquid not found. Ensure workflow runs at theme repository root."
+            exit 1
+          fi
+
+      - name: Install Shopify CLI
+        run: npm install -g @shopify/cli @shopify/theme
+
+      - name: Share theme
+        id: share
+        env:
+          SHOPIFY_STORE_URL: ${{ inputs.store_alias_secret && secrets[format('SHOPIFY_STORE_URL_{0}', inputs.store_alias_secret)] || secrets.SHOPIFY_STORE_URL }}
+          SHOPIFY_THEME_ACCESS_TOKEN: ${{ inputs.store_alias_secret && secrets[format('SHOPIFY_THEME_ACCESS_TOKEN_{0}', inputs.store_alias_secret)] || secrets.SHOPIFY_THEME_ACCESS_TOKEN }}
+        run: |
+          if [ -z "$SHOPIFY_STORE_URL" ] || [ -z "$SHOPIFY_THEME_ACCESS_TOKEN" ]; then
+            echo "Missing Shopify secrets."
+            exit 1
+          fi
+
+          OUTPUT=$(shopify theme share \
+            --store "$SHOPIFY_STORE_URL" \
+            --password "$SHOPIFY_THEME_ACCESS_TOKEN" 2>&1)
+          STATUS=$?
+
+          echo "$OUTPUT"
+          if [ $STATUS -ne 0 ]; then
+            echo "Theme share failed."
+            exit $STATUS
+          fi
+
+          THEME_NAME=$(echo "$OUTPUT" | sed -n "s/.*The theme '\([^']*\)'.*/\1/p" | head -1)
+          THEME_ID=$(echo "$OUTPUT" | sed -n 's/.*#\([0-9]*\).*/\1/p' | head -1)
+
+          if [ -z "$THEME_ID" ]; then
+            echo "Could not parse theme id from share output."
+            exit 1
+          fi
+
+          echo "theme_id=$THEME_ID" >> "$GITHUB_OUTPUT"
+          if [ -n "$THEME_NAME" ]; then
+            echo "theme_name=$THEME_NAME" >> "$GITHUB_OUTPUT"
+          fi
+
+          {
+            echo "share_output<<SHARE_EOF"
+            echo "$OUTPUT"
+            echo "SHARE_EOF"
+          } >> "$GITHUB_OUTPUT"
+
+      - name: Rename theme with PR suffix
+        id: rename
+        env:
+          SHOPIFY_STORE_URL: ${{ inputs.store_alias_secret && secrets[format('SHOPIFY_STORE_URL_{0}', inputs.store_alias_secret)] || secrets.SHOPIFY_STORE_URL }}
+          SHOPIFY_THEME_ACCESS_TOKEN: ${{ inputs.store_alias_secret && secrets[format('SHOPIFY_THEME_ACCESS_TOKEN_{0}', inputs.store_alias_secret)] || secrets.SHOPIFY_THEME_ACCESS_TOKEN }}
+          THEME_ID: ${{ steps.share.outputs.theme_id }}
+          THEME_NAME: ${{ steps.share.outputs.theme_name }}
+          PR_NUMBER: ${{ inputs.pr_number }}
+        run: |
+          if [ -z "$THEME_ID" ] || [ -z "$THEME_NAME" ]; then
+            echo "Missing theme_id/theme_name from share step."
+            exit 1
+          fi
+          if [ -z "$SHOPIFY_STORE_URL" ] || [ -z "$SHOPIFY_THEME_ACCESS_TOKEN" ]; then
+            echo "Missing Shopify store URL/token for rename."
+            exit 1
+          fi
+
+          NEW_THEME_NAME="${THEME_NAME}-PR${PR_NUMBER}"
+          echo "Renaming theme $THEME_ID to '$NEW_THEME_NAME'..."
+
+          if shopify theme rename \
+            --store "$SHOPIFY_STORE_URL" \
+            --password "$SHOPIFY_THEME_ACCESS_TOKEN" \
+            --theme "$THEME_ID" \
+            --name "$NEW_THEME_NAME" 2>&1; then
+            echo "Rename succeeded with password auth."
+          elif shopify theme rename \
+            --store "$SHOPIFY_STORE_URL" \
+            --theme "$THEME_ID" \
+            --name "$NEW_THEME_NAME" 2>&1; then
+            echo "Rename succeeded with authenticated session."
+          else
+            echo "Failed to rename theme."
+            exit 1
+          fi
+
+          echo "theme_id=$THEME_ID" >> "$GITHUB_OUTPUT"
+          echo "theme_name=$NEW_THEME_NAME" >> "$GITHUB_OUTPUT"
+
+      - name: Write preview fragment for PR comment
+        env:
+          STORE_ALIAS: ${{ inputs.store_alias }}
+          THEME_ID: ${{ steps.rename.outputs.theme_id }}
+          SHOPIFY_STORE_URL: ${{ inputs.store_alias_secret && secrets[format('SHOPIFY_STORE_URL_{0}', inputs.store_alias_secret)] || secrets.SHOPIFY_STORE_URL }}
+        run: |
+          node <<'NODE'
+          const fs = require('fs');
+          const url = (process.env.SHOPIFY_STORE_URL || '')
+            .replace(/^https?:\/\//, '')
+            .replace(/\/.*$/, '');
+          const payload = {
+            alias: process.env.STORE_ALIAS || '',
+            theme_id: process.env.THEME_ID || '',
+            store_host: url,
+          };
+          fs.writeFileSync('fragment.json', JSON.stringify(payload, null, 0));
+          NODE
+
+      - name: Upload preview fragment
+        uses: actions/upload-artifact@v4
+        with:
+          name: preview-fragment-${{ inputs.store_alias }}
+          path: fragment.json
+          retention-days: 2