umpordez 1.2.1 → 1.3.1

package/template/mobile/{{PROJECT_SLUG}}/docs/store-copy.md

@@ -0,0 +1,122 @@
+# {{PROJECT_NAME}} — Store Copy (pt-BR · en)
+
+> **This is the single canonical source for ship copy** — app name,
+> subtitle, promotional text, keywords, short description and full
+> descriptions (App Store + Google Play, per locale). Paste straight from
+> here into App Store Connect / Google Play Console.
+>
+> Pricing, category, compliance reasoning and the publishing checklist
+> live in [`store-listing.md`](./store-listing.md); release / "What's New"
+> copy lives in [`releases.md`](./releases.md). This file is just the
+> descriptive text.
+
+**Positioning.** _One or two sentences on what {{PROJECT_NAME}} is and the
+promise a user feels immediately. Lead with that promise in every field
+below._
+
+**House style**: never a hyphen as a separator; use `;` `,` `.` instead.
+Write each store's description separately — never reuse one verbatim, since
+"App Store" reads wrong on Play and vice-versa.
+
+> ⚠️ **Confirm before submit**: support email and privacy-policy URL are
+> live (e.g. `contato@{{DOMAIN}}`, `https://{{DOMAIN}}/privacidade` and
+> `/privacy`).
+
+---
+
+## Format reference
+
+### App Store Connect (per locale)
+| Field | Limit | Editable post-submit? |
+|---|---|---|
+| App Name | 30 chars | needs new binary |
+| Subtitle | 30 chars | needs new binary |
+| Promotional Text | 170 chars | **yes** — change anytime |
+| Description | 4000 chars | needs new binary |
+| Keywords | 100 chars (CSV, no spaces) | needs new binary |
+| What's New | 4000 chars | per release (see releases.md) |
+
+### Google Play Console (per locale)
+| Field | Limit |
+|---|---|
+| App name | 30 chars |
+| Short description | 80 chars |
+| Full description | 4000 chars |
+
+---
+
+# 🇧🇷 pt-BR — Português (Brasil)
+
+**App name** (≤30)
+```
+{{PROJECT_NAME}}
+```
+
+**Subtitle — App Store** (≤30)
+```
+
+```
+
+**Promotional Text — App Store** (≤170)
+```
+
+```
+
+**Keywords — App Store** (≤100, CSV no spaces)
+```
+
+```
+
+**Short description — Google Play** (≤80)
+```
+
+```
+
+### Full description — App Store (iOS)
+```
+
+```
+
+### Full description — Google Play (Android, keyword-rich)
+```
+
+```
+
+---
+
+# 🇺🇸 en — English
+
+**App name** (≤30)
+```
+{{PROJECT_NAME}}
+```
+
+**Subtitle — App Store** (≤30)
+```
+
+```
+
+**Promotional Text — App Store** (≤170)
+```
+
+```
+
+**Keywords — App Store** (≤100, CSV no spaces)
+```
+
+```
+
+**Short description — Google Play** (≤80)
+```
+
+```
+
+### Full description — App Store (iOS)
+```
+
+```
+
+### Full description — Google Play (Android, keyword-rich)
+```
+
+```

package/template/mobile/{{PROJECT_SLUG}}/docs/store-listing.md

@@ -0,0 +1,107 @@
+# Store listing — {{PROJECT_NAME}}
+
+Everything needed to publish {{PROJECT_NAME}} on both stores: the pricing
+model, the category/compliance reasoning, the ASO strategy and the
+publishing checklist.
+
+> **The actual ship copy** (app name, subtitle, promotional text,
+> keywords, short description and full descriptions per locale) lives in
+> [`store-copy.md`](./store-copy.md). Release / "What's New" copy lives in
+> [`releases.md`](./releases.md). Paste straight from there into App Store
+> Connect / Google Play Console.
+
+House style for the marketing copy: never a hyphen as a separator; use
+`;` `,` `.` instead.
+
+---
+
+## Pricing
+
+Pick the model before you write the copy — it decides what trust signals
+lead the listing.
+
+| Model | What it unlocks | Notes |
+|---|---|---|
+| Free | Everything, no purchase | Lead with "free, no account, no ads". |
+| Paid once | The whole app, one payment | Lowest paid bracket = impulse buy. Lead with "pay once, yours forever". |
+| Freemium (IAP) | Free core + Premium unlock | Product IDs must match `src/services/iap/index.ts` exactly. |
+
+If you use IAP, declare the product IDs here and keep them in lockstep
+with the app:
+
+```
+{{PROJECT_SLUG}}_premium_monthly
+{{PROJECT_SLUG}}_premium_annual
+```
+
+The app is anonymous-first: install creates a device account; a purchase
+ties Premium to the user's Apple/Google account at buy time.
+
+---
+
+## Category
+
+- **Apple App Store:** primary category — pick where comparable apps rank.
+- **Google Play:** primary category + up to 5 tags from Google's curated
+  list.
+
+### Compliance note
+
+Keep metadata at the **widest age rating you can**. Age gates and
+sensitive-topic keywords (drugs, gambling, mature themes) push the rating
+up on Apple and trip Google Play's IARC questionnaire toward Mature —
+both trim country availability. If the app content is neutral, keep the
+listing neutral and stay at 4+ / Everyone for the widest reach.
+
+---
+
+## ASO strategy
+
+Field limits (hard caps):
+
+| Field | Apple App Store | Google Play |
+|---|---|---|
+| Title | 30 | 30 |
+| Subtitle | 30 | — |
+| Short description | — | 80 |
+| Promotional text | 170 | — |
+| Keywords | 100 (commas, no spaces, single words) | — |
+| Full description | 4000 (not indexed) | 4000 (indexed) |
+
+Principles:
+
+- **Front-load the title.** Apple weights the first word most; brand
+  first, then the strongest keyword phrase (e.g. `{{PROJECT_NAME}}: <keyword>`).
+- **Apple keywords never repeat** title/subtitle words (repeats add no
+  ranking weight); single words, comma-separated, no spaces.
+- **Play indexes the full description**; Apple does not. Weave keywords
+  naturally into the Play description; keep the Apple description pure
+  conversion.
+- **Lead with trust**: no ads, no tracking, no account (whichever apply),
+  works offline. State the price model plainly.
+
+---
+
+## Publishing checklist (store console clickwork)
+
+Neither store exposes paid pricing or metadata via API, so these are
+manual:
+
+- ⬜ Create the App Store Connect record; accept Apple Developer terms
+- ⬜ Create the Play Console app record
+- ⬜ Set the price / free (both stores)
+- ⬜ (If IAP) create the subscription/products with the exact IDs above
+- ⬜ Paste the metadata for each language from [`store-copy.md`](./store-copy.md)
+- ⬜ Set the category on both stores
+- ⬜ Upload icon + screenshots (see [`screenshots.md`](./screenshots.md))
+- ⬜ Privacy policy URL live (e.g. `https://{{DOMAIN}}/privacidade`)
+- ⬜ Data safety / privacy nutrition label filled in honestly
+- ⬜ First build submitted via `../../scripts/release-android.sh` (Play)
+  and EAS / Xcode (App Store)
+
+Bundle IDs (must match `app.json`):
+
+```
+iOS      {{IOS_BUNDLE_ID}}
+Android  {{ANDROID_PACKAGE}}
+```

package/template/mobile/{{PROJECT_SLUG}}/src/config.ts

@@ -41,6 +41,12 @@ const APP_VERSION = '0.1.0';
 const GOOGLE_CLIENT_ID = 'TODO_GOOGLE_WEB_CLIENT_ID';
 const GOOGLE_IOS_CLIENT_ID = 'TODO_GOOGLE_IOS_CLIENT_ID';
 
+// Splash behavior. `false` (instant show-up) hides the native splash the
+// moment fonts load — the app feels immediate, no decorative delay.
+// `true` plays the AnimatedSplash (glow + logo + pulse) before the app
+// appears. Set at scaffold time via `umpordez create`.
+export const SPLASH_ANIMATED = {{SPLASH_ANIMATED}};
+
 if (__DEV__) {
     console.log(
         `[config] API: ${baseApiUrl} | prod=${isProdBuild} `

package/template/scripts/README.md

@@ -16,15 +16,32 @@ you find every command in one place.
 | `generate-icons.sh` | (Re)generate the icon/splash asset set. From-scratch (uses primary color + first letter) or from a source PNG. |
 | `extract-play-key.js` | Pull `GOOGLE_PLAY_SERVICE_ACCOUNT_JSON` out of `server/.env` and write it to `mobile/<slug>/google-play-key.json` for `eas submit`. Called automatically by `release-android.sh`. |
 
+## Store screenshots
+
+| Script | What it does |
+|---|---|
+| `gen-mockups.mjs` | Render headless store-screen mockups (branded, no simulator) → `mobile/<slug>/screenshots/raw[/-tablet]`. Starting point — edit `SCREENS` + `LABELS` to match your app. |
+| `screenshots-capture.sh` | Drive the Maestro flow on a booted sim/emulator for both locales → raw PNGs. `phone` or `tablet`. Tune labels to your nav. |
+| `screenshots.flow.yaml` | The Maestro flow (reset → onboarding → language → walk tabs → capture). |
+| `frame-shots.mjs` | Frame raw PNGs into branded, captioned, store-ready sizes (iPhone/Android/iPad/tablet). `--selftest`, `--preset=`, `--locale=`. |
+| `appstore-resize.sh` | Re-encode iPhone PNG screenshots to the exact App Store Connect JPEG sizes (6.5/6.7/6.9in), stripping alpha. |
+
+See [`../mobile/<slug>/docs/screenshots.md`](../mobile) for the full
+capture → frame → upload workflow, and `docs/store-listing.md` /
+`store-copy.md` / `releases.md` for the listing + release copy.
+
 ## Server / web stack
 
 These live at the project root (one level up from this dir):
 
+These live at the project root (one level up from this dir):
+
 | Script | What it does |
 |---|---|
 | `install.sh` | Install npm deps for every sub-project. Pass `--native` to also run `expo prebuild`, `pod install`, and `install-native.sh` for mobile. |
 | `seed.sh` | Create the database, run migrations, seed admin user. |
-| `dev.sh` | Start every service that exists (server, admin UI, site UI). Pass `--mobile` to also start Expo Metro. |
+| `dev.sh` | Start every service that exists (server, admin UI, site UI). Mobile Metro starts by default; pass `--no-mobile` to skip it. |
+| `misc/build-local.sh` | Production build of server + admin SPA + site into `../builds/` with a build number. `--push` to commit + push the builds repo. |
 
 ## Conventions
 

package/template/scripts/appstore-resize.sh

@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+#
+# Resize iPhone screenshots to App Store Connect sizes.
+#
+# Usage:
+#   ./appstore-resize.sh <file1.png> [file2.png ...]
+#   ./appstore-resize.sh *.png
+#
+# Outputs each input as three new files in the same folder:
+#   <name>-6.5in.jpg   1242 x 2688   (iPhone XS Max / 11 Pro Max)
+#   <name>-6.7in.jpg   1290 x 2796   (iPhone 14 Pro Max class)
+#   <name>-6.9in.jpg   1320 x 2868   (iPhone 16 Pro Max)
+#
+# Why JPEG? macOS screenshots are PNG with an alpha channel.
+# App Store Connect rejects PNGs that carry alpha — and reports
+# the failure as "dimensions are wrong", which is misleading.
+# JPEG has no alpha by definition, so re-encoding sidesteps the
+# whole issue. Quality at formatOptions=best is visually lossless
+# for typical UI screenshots.
+
+set -euo pipefail
+
+if [ $# -eq 0 ]; then
+    echo "usage: $0 <screenshot.png> [more.png ...]"
+    exit 1
+fi
+
+# size_label  width  height
+SIZES=(
+    "6.5in 1242 2688"
+    "6.7in 1290 2796"
+    "6.9in 1320 2868"
+)
+
+for src in "$@"; do
+    if [ ! -f "$src" ]; then
+        echo "skip: $src (not found)"
+        continue
+    fi
+
+    dir=$(dirname "$src")
+    base=$(basename "$src")
+    name="${base%.*}"
+
+    w=$(sips -g pixelWidth  "$src" | awk '/pixelWidth/  {print $2}')
+    h=$(sips -g pixelHeight "$src" | awk '/pixelHeight/ {print $2}')
+    if [ -z "$w" ] || [ -z "$h" ]; then
+        echo "skip: $src (couldn't read dimensions)"
+        continue
+    fi
+    ratio=$(awk -v a="$w" -v b="$h" 'BEGIN { printf "%.4f", a/b }')
+    echo "→ $base  ${w}x${h}  ratio=$ratio"
+
+    for entry in "${SIZES[@]}"; do
+        read -r label tw th <<< "$entry"
+        out="$dir/$name-$label.jpg"
+        # One-shot: convert to JPEG at max quality AND resize.
+        # `-s format jpeg` drops the alpha channel; --resampleHeightWidth
+        # is height-then-width per sips' argument order.
+        sips \
+            -s format jpeg \
+            -s formatOptions best \
+            --resampleHeightWidth "$th" "$tw" \
+            "$src" \
+            --out "$out" > /dev/null
+        echo "   wrote $out  (${tw}x${th})"
+    done
+done
+
+echo "done."

package/template/scripts/frame-shots.mjs

@@ -0,0 +1,246 @@
+#!/usr/bin/env node
+/**
+ * frame-shots — turn raw app screenshots into branded, captioned,
+ * store-ready images at the exact sizes Apple / Google require.
+ *
+ * No design tools: each raw capture is composited into an SVG (brand
+ * gradient background + caption + the screenshot with rounded corners
+ * and a soft shadow) and rendered to PNG with @resvg/resvg-js.
+ * Deterministic and re-runnable.
+ *
+ * Raw screens come from either:
+ *   • scripts/gen-mockups.mjs   (headless, no simulator), or
+ *   • Maestro capture           (scripts/screenshots-capture.sh)
+ * both write to mobile/{{PROJECT_SLUG}}/screenshots/raw[/-tablet]/<locale>/.
+ *
+ * Usage:
+ *   node scripts/frame-shots.mjs                 # all presets, all locales
+ *   node scripts/frame-shots.mjs --preset=iphone
+ *   node scripts/frame-shots.mjs --locale=en
+ *   node scripts/frame-shots.mjs --selftest      # render a demo frame
+ *
+ * Numeric file prefixes (00-*, 01-*, …) drive order + caption lookup.
+ * Edit CAPTIONS below to mirror docs/store-copy.md.
+ */
+
+import {
+    readFileSync, writeFileSync, mkdirSync, readdirSync, existsSync
+} from 'node:fs';
+import { dirname, join, basename } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createRequire } from 'node:module';
+
+const REPO = join(dirname(fileURLToPath(import.meta.url)), '..');
+const APP = join(REPO, 'mobile', '{{PROJECT_SLUG}}');
+const require = createRequire(join(APP, 'package.json'));
+const { Resvg } = require('@resvg/resvg-js');
+
+const SHOTS = join(APP, 'screenshots');
+// Optional bundled brand fonts — drop .ttf files in assets/fonts to use
+// them. Without any, resvg falls back to a system sans-serif.
+const FONTS = ['Display.ttf', 'Body.ttf']
+    .map(f => join(APP, 'assets', 'fonts', f))
+    .filter(existsSync);
+const FONT_DISPLAY = 'sans-serif';
+const FONT_BODY = 'sans-serif';
+
+// ── Brand gradient (from the project's primary color) ───────────────
+const BRAND_TOP = '{{PRIMARY_COLOR_DARK}}';   // lifted primary (lighter)
+const BRAND_BOT = '{{PRIMARY_COLOR}}';        // primary
+const CAPTION_COLOR = '#FFFFFF';
+
+// ── Store size presets ──────────────────────────────────────────────
+const PRESETS = {
+    // Apple App Store — iPhone 6.9" (1290×2796) / 6.5" accepted.
+    iphone: { source: 'phone', w: 1290, h: 2796, radius: 62, capSize: 80, capTop: 150, sideMargin: 130, gap: 66 },
+    // Google Play phone (9:19.5).
+    android: { source: 'phone', w: 1080, h: 2340, radius: 52, capSize: 66, capTop: 120, sideMargin: 120, gap: 56 },
+    // Apple 13" iPad — required when supportsTablet=true.
+    ipad: { source: 'tablet', w: 2048, h: 2732, radius: 44, capSize: 92, capTop: 170, sideMargin: 260, gap: 90 },
+    // Google Play tablet (portrait 16:10).
+    androidtablet: { source: 'tablet', w: 1600, h: 2560, radius: 40, capSize: 74, capTop: 150, sideMargin: 200, gap: 74 },
+};
+
+// ── Captions: headline + subtitle per shot ──────────────────────────
+// Keyed by the numeric filename prefix. Mirror docs/store-copy.md; the
+// first + last carry the strongest download pitch (most visitors only
+// see the first 2–3 frames). Add keys as you add screens.
+const CAPTIONS = {
+    '00': {
+        'pt-BR': { h: 'A tela inicial', s: 'Tudo o que importa, à mão' },
+        en: { h: 'Your home screen', s: 'Everything that matters, at hand' },
+    },
+    '01': {
+        'pt-BR': { h: 'Explore e encontre', s: 'Busque em um instante' },
+        en: { h: 'Explore and find', s: 'Search in an instant' },
+    },
+    '02': {
+        'pt-BR': { h: 'Sua biblioteca', s: 'Organizado do seu jeito' },
+        en: { h: 'Your library', s: 'Organized your way' },
+    },
+    '03': {
+        'pt-BR': { h: 'Feito para você', s: 'Local, privado, sem anúncios' },
+        en: { h: 'Made for you', s: 'Local, private, no ads' },
+    },
+};
+
+// ── Helpers ─────────────────────────────────────────────────────────
+function pngSize(buf) {
+    return { w: buf.readUInt32BE(16), h: buf.readUInt32BE(20) };
+}
+
+function wrap(text, maxChars, maxLines = 2) {
+    const words = text.split(' ');
+    const lines = [];
+    let cur = '';
+    for (const word of words) {
+        const next = cur ? `${cur} ${word}` : word;
+        if (next.length > maxChars && cur) {
+            lines.push(cur);
+            cur = word;
+        } else {
+            cur = next;
+        }
+    }
+    if (cur) {
+        lines.push(cur);
+    }
+    return lines.slice(0, maxLines);
+}
+
+function esc(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+
+function buildSvg(preset, caption, imgDataUri, imgW, imgH) {
+    const { w, h, radius, capSize, capTop, sideMargin, gap } = preset;
+    const head = caption?.h ?? '';
+    const sub = caption?.s ?? '';
+
+    const maxImgW = w - sideMargin * 2;
+    const maxTextW = w - Math.round(sideMargin * 0.7) * 2;
+    const headLines = wrap(head, Math.floor(maxTextW / (capSize * 0.54)));
+    const subSize = Math.round(capSize * 0.5);
+    const subLines = sub ? wrap(sub, Math.floor(maxTextW / (subSize * 0.52))) : [];
+    const headLineH = capSize * 1.16;
+    const subLineH = subSize * 1.4;
+    const headBottom = capTop + capSize + (headLines.length - 1) * headLineH;
+    const subTop = headBottom + (subLines.length ? subSize * 1.7 : 0);
+    const capBlock = subLines.length
+        ? subTop + (subLines.length - 1) * subLineH + subSize * 0.4
+        : headBottom + capSize * 0.2;
+    const availH = h - capBlock - gap - Math.round(h * 0.03);
+
+    let drawW = maxImgW;
+    let drawH = (drawW * imgH) / imgW;
+    if (drawH > availH) {
+        drawH = availH;
+        drawW = (drawH * imgW) / imgH;
+    }
+    const drawX = (w - drawW) / 2;
+    const drawY = capBlock + gap;
+
+    const caps = headLines.map((line, i) =>
+        `<text x="${w / 2}" y="${capTop + capSize + i * headLineH}" text-anchor="middle" ` +
+        `font-family="${FONT_DISPLAY}" font-weight="700" font-size="${capSize}" fill="${CAPTION_COLOR}">${esc(line)}</text>`
+    ).concat(subLines.map((line, i) =>
+        `<text x="${w / 2}" y="${subTop + i * subLineH}" text-anchor="middle" ` +
+        `font-family="${FONT_BODY}" font-weight="600" font-size="${subSize}" fill="${CAPTION_COLOR}" fill-opacity="0.82">${esc(line)}</text>`
+    )).join('\n');
+
+    return `<svg xmlns="http://www.w3.org/2000/svg" width="${w}" height="${h}" viewBox="0 0 ${w} ${h}">
+  <defs>
+    <linearGradient id="bg" x1="0" y1="0" x2="0" y2="1">
+      <stop offset="0" stop-color="${BRAND_TOP}"/>
+      <stop offset="1" stop-color="${BRAND_BOT}"/>
+    </linearGradient>
+    <clipPath id="round"><rect x="${drawX}" y="${drawY}" width="${drawW}" height="${drawH}" rx="${radius}" ry="${radius}"/></clipPath>
+    <filter id="shadow" x="-20%" y="-20%" width="140%" height="140%">
+      <feDropShadow dx="0" dy="24" stdDeviation="40" flood-color="#000000" flood-opacity="0.30"/>
+    </filter>
+  </defs>
+  <rect width="${w}" height="${h}" fill="url(#bg)"/>
+  <ellipse cx="${w / 2}" cy="${drawY + drawH * 0.28}" rx="${w * 0.64}" ry="${h * 0.26}" fill="#FFFFFF" opacity="0.08"/>
+  ${caps}
+  <rect x="${drawX}" y="${drawY}" width="${drawW}" height="${drawH}" rx="${radius}" ry="${radius}" fill="#000" filter="url(#shadow)"/>
+  <image href="${imgDataUri}" x="${drawX}" y="${drawY}" width="${drawW}" height="${drawH}" preserveAspectRatio="xMidYMid slice" clip-path="url(#round)"/>
+  <rect x="${drawX}" y="${drawY}" width="${drawW}" height="${drawH}" rx="${radius}" ry="${radius}" fill="none" stroke="#FFFFFF" stroke-opacity="0.16" stroke-width="2"/>
+</svg>`;
+}
+
+function render(svg, w) {
+    return new Resvg(svg, {
+        fitTo: { mode: 'width', value: w },
+        font: {
+            fontFiles: FONTS,
+            loadSystemFonts: FONTS.length === 0,
+            defaultFontFamily: 'sans-serif'
+        },
+    }).render().asPng();
+}
+
+const RAW_DIR = { phone: 'raw', tablet: 'raw-tablet' };
+
+function selftest() {
+    const demo = `<svg xmlns="http://www.w3.org/2000/svg" width="1080" height="2340">
+      <rect width="1080" height="2340" fill="#0F1416"/>
+      <rect x="80" y="300" width="920" height="240" rx="34" fill="${BRAND_BOT}"/>
+      <text x="130" y="440" font-family="${FONT_DISPLAY}" font-weight="700" font-size="120" fill="#FFFFFF">1</text>
+    </svg>`;
+    const raw = render(demo, 1080);
+    const { w, h } = pngSize(raw);
+    const uri = `data:image/png;base64,${raw.toString('base64')}`;
+    const outDir = join(SHOTS, 'store', '_selftest');
+    mkdirSync(outDir, { recursive: true });
+    for (const [name, preset] of Object.entries(PRESETS)) {
+        writeFileSync(join(outDir, `${name}.png`),
+            render(buildSvg(preset, CAPTIONS['00']['pt-BR'], uri, w, h), preset.w));
+        console.log(`  ✓ ${name}.png (${preset.w}×${preset.h})`);
+    }
+    console.log(`Self-test frames → ${outDir}`);
+}
+
+function frameAll(opts) {
+    const presets = Object.entries(PRESETS).filter(([n]) => !opts.preset || n === opts.preset);
+    const anyRaw = Object.values(RAW_DIR).some(d => existsSync(join(SHOTS, d)));
+    if (!anyRaw) {
+        console.error('No raw screenshots under mobile/{{PROJECT_SLUG}}/screenshots/raw[/-tablet].');
+        console.error('Generate them:  node scripts/gen-mockups.mjs');
+        console.error('Or preview framing:  node scripts/frame-shots.mjs --selftest');
+        process.exit(1);
+    }
+    let count = 0;
+    for (const [presetName, preset] of presets) {
+        const rawRoot = join(SHOTS, RAW_DIR[preset.source]);
+        if (!existsSync(rawRoot)) {
+            console.log(`  – ${presetName}: skipped (no ${RAW_DIR[preset.source]}/ yet)`);
+            continue;
+        }
+        const locales = readdirSync(rawRoot).filter(d => !opts.locale || d === opts.locale);
+        for (const locale of locales) {
+            const files = readdirSync(join(rawRoot, locale)).filter(f => f.endsWith('.png')).sort();
+            const outDir = join(SHOTS, 'store', presetName, locale);
+            mkdirSync(outDir, { recursive: true });
+            for (const file of files) {
+                const key = basename(file).slice(0, 2);
+                const caption = CAPTIONS[key]?.[locale] ?? CAPTIONS[key]?.en ?? { h: '', s: '' };
+                const raw = readFileSync(join(rawRoot, locale, file));
+                const { w, h } = pngSize(raw);
+                const uri = `data:image/png;base64,${raw.toString('base64')}`;
+                writeFileSync(join(outDir, file), render(buildSvg(preset, caption, uri, w, h), preset.w));
+                count++;
+            }
+            console.log(`  ✓ ${presetName}/${locale}: ${files.length} frames`);
+        }
+    }
+    console.log(`Done — ${count} store images under mobile/{{PROJECT_SLUG}}/screenshots/store/`);
+}
+
+const opts = Object.fromEntries(
+    process.argv.slice(2).map(a => a.replace(/^--/, '').split('=')).map(([k, v]) => [k, v ?? true])
+);
+if (opts.selftest) {
+    selftest();
+} else {
+    frameAll(opts);
+}