@daemux/store-automator 0.1.0 → 0.2.0

package/.claude-plugin/marketplace.json

@@ -5,14 +5,14 @@
   },
   "metadata": {
     "description": "App Store & Google Play automation for Flutter apps",
-    "version": "0.1.0"
+    "version": "0.2.0"
   },
   "plugins": [
     {
       "name": "store-automator",
       "source": "./plugins/store-automator",
       "description": "3 agents for app store publishing: reviewer, meta-creator, media-designer",
-      "version": "0.1.0",
+      "version": "0.2.0",
       "keywords": ["flutter", "app-store", "google-play", "fastlane", "codemagic"]
     }
   ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@daemux/store-automator",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Full App Store & Google Play automation for Flutter apps with Claude Code agents",
   "type": "module",
   "bin": {
@@ -17,16 +17,28 @@
     "templates/"
   ],
   "keywords": [
-    "claude", "claude-code", "plugin", "flutter", "app-store",
-    "google-play", "fastlane", "codemagic", "ci-cd", "daemux"
+    "claude",
+    "claude-code",
+    "plugin",
+    "flutter",
+    "app-store",
+    "google-play",
+    "fastlane",
+    "codemagic",
+    "ci-cd",
+    "daemux"
   ],
-  "author": { "name": "Daemux" },
+  "author": {
+    "name": "Daemux"
+  },
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "https://github.com/daemux/store-automator.git"
   },
-  "engines": { "node": ">=18" },
+  "engines": {
+    "node": ">=18"
+  },
   "dependencies": {
     "update-notifier": "^7.3.1"
   }

package/plugins/store-automator/agents/appstore-media-designer.md

@@ -148,35 +148,69 @@ fastlane/screenshots/android/
     icon.png
 ```
 
-## Using Stitch MCP for Design
+## Available MCP Tools
 
-When Stitch MCP is available (GOOGLE_API_KEY configured):
+You MUST use these MCP tools for all design work. Check availability first:
 
-1. List existing Stitch projects to check for prior work
-2. Create a new Stitch project named "{app-name}-store-screenshots"
-3. For each screenshot scene, generate a screen with a detailed prompt:
+### 1. Stitch MCP (PRIMARY design tool)
+- Configured via STITCH_API_KEY in .mcp.json
+- Use `stitch_*` tools for all image creation and design
+- This is your main tool for creating professional screenshots and graphics
+
+### 2. mobile-mcp (for real app screenshots)
+- Can capture actual screenshots from iOS Simulator or Android Emulator
+- Use to get real app UI screenshots as source material for Stitch designs
+- Requires the app to be built and running on a simulator
+
+### 3. Playwright MCP (for web screenshots)
+- Can capture screenshots of web pages
+- Useful for marketing page previews
+
+## Design Workflow with Stitch MCP
+
+**MANDATORY: All visual assets MUST be created using Stitch MCP. Do NOT create placeholder or text-only images.**
+
+### Step 1: Capture App UI
+Use mobile-mcp to capture real app screens from the simulator, OR read the source code to understand each screen layout.
+
+### Step 2: Create Screenshots via Stitch MCP
+For each of the 5 scenes:
+
+1. Call Stitch MCP to create a new design project named "{app-name}-store-screenshots"
+2. For each scene, use Stitch MCP with a detailed design prompt:
    - Describe the exact layout: background color/gradient, app screen placement, headline text
    - Specify the app's color palette (extract from theme.dart or design specs)
    - Reference the actual app screen content for that scene
-4. Export each screen at every required device dimension
-5. Apply headline text overlays
-6. Save to the correct directory paths
+3. Generate at every required device dimension
+4. Export and save to the correct directory paths
 
-### Stitch Prompt Template
+### Stitch Design Prompt Template
 
-For each scene, construct a prompt like:
+For each scene, use a prompt like:
 ```
-App store screenshot for a [app type] app.
-Background: [gradient/color description].
-Center: phone mockup showing [specific screen description].
-Top text: "[headline text]" in [font style], [color].
-Style: clean, modern, professional app store screenshot.
+Professional app store screenshot for a [app type] app.
+Background: [gradient/color description matching app theme].
+Center: phone mockup showing [specific screen description with UI details].
+Top headline: "[headline text]" in bold sans-serif, white color.
+Bottom subheadline: "[subtitle]" in regular weight, semi-transparent white.
+Style: clean, modern, minimal. Apple App Store quality.
 Dimensions: [width]x[height] pixels.
+Color palette: primary [#hex], secondary [#hex], accent [#hex].
 ```
 
-## Fallback Without Stitch MCP
+### Step 3: Create Feature Graphic (Google Play, required)
+Use Stitch MCP to create the 1024x500 feature graphic:
+- App name prominently displayed
+- App icon or key UI element
+- Tagline or value proposition
+- Brand colors
+
+### Step 4: Create App Icon Variants
+Use Stitch MCP for any icon variants needed (512x512 for Google Play).
+
+## Fallback: If Stitch MCP is unavailable
 
-If Stitch MCP is NOT available, create a detailed design specification file:
+Only if Stitch MCP tools are not available, create a design specification:
 
 Save to `fastlane/screenshots/design-spec.json`:
 ```json
@@ -199,7 +233,7 @@ Save to `fastlane/screenshots/design-spec.json`:
 }
 ```
 
-The developer agent can then create screenshots programmatically using Flutter widget tests or a dedicated screenshot generation script.
+Then use mobile-mcp to capture real app screenshots from simulator and composite them with Flutter widget tests or a screenshot generation script.
 
 ## Output Verification Checklist
 

package/plugins/store-automator/agents/appstore-reviewer.md

@@ -139,6 +139,41 @@ Read fastlane/app_rating_config.json and verify:
 - **Subscription policy**: clear terms displayed before purchase, easy cancellation path
 - **Content rating**: accurate IARC questionnaire responses, consistent with app content
 
+## Pre-Submission Checklist
+
+Before running the full review, verify these mandatory items. Include checkbox results in the output.
+
+### Apple App Store Mandatory Items
+- [ ] App name (name.txt) present and <= 30 characters
+- [ ] Subtitle (subtitle.txt) present and <= 30 characters
+- [ ] Description (description.txt) present and <= 4000 characters
+- [ ] Keywords (keywords.txt) present and <= 100 characters total
+- [ ] Privacy URL (privacy_url.txt) present with valid https:// URL
+- [ ] Support URL (support_url.txt) present with valid https:// URL
+- [ ] At least 1 screenshot per required device class (6.7", 6.5", iPad 12.9")
+- [ ] App icon present (1024x1024 in Assets.xcassets)
+- [ ] Bundle ID matches ci.config.yaml
+- [ ] Age rating config (app_rating_config.json) present and complete
+- [ ] Privacy policy page loads and contains required sections
+
+### Google Play Mandatory Items
+- [ ] Title (title.txt) present and <= 30 characters
+- [ ] Short description (short_description.txt) present and <= 80 characters
+- [ ] Full description (full_description.txt) present and <= 4000 characters
+- [ ] Feature graphic present (exactly 1024x500)
+- [ ] At least 2 phone screenshots present
+- [ ] App icon (512x512) present
+- [ ] Package name matches ci.config.yaml
+- [ ] Changelog (changelogs/default.txt) present
+- [ ] Privacy policy page loads and contains required sections
+- [ ] Content rating questionnaire answers present
+
+### Both Platforms
+- [ ] All metadata files exist for every language in ci.config.yaml metadata.languages
+- [ ] IAP config (iap_config.json) valid if app has subscriptions
+- [ ] No placeholder text remaining in any metadata file
+- [ ] Web pages (privacy, terms, support) deploy successfully
+
 ## Output Format
 
 ```

package/src/install.mjs

@@ -11,7 +11,7 @@ import { injectEnvVars, injectStatusLine } from './settings.mjs';
 import { ensureClaudePlugin } from './dependency-check.mjs';
 import { promptForTokens } from './prompt.mjs';
 import { getMcpServers, writeMcpJson } from './mcp-setup.mjs';
-import { installClaudeMd, installCiTemplates } from './templates.mjs';
+import { installClaudeMd, installCiTemplates, installFirebaseTemplates } from './templates.mjs';
 
 function checkClaudeCli() {
   const result = exec('command -v claude') || exec('which claude');
@@ -124,6 +124,7 @@ export async function runInstall(scope, isPostinstall = false) {
 
   installClaudeMd(join(baseDir, 'CLAUDE.md'), packageDir);
   installCiTemplates(projectDir, packageDir);
+  installFirebaseTemplates(projectDir, packageDir);
 
   const scopeLabel = scope === 'user' ? 'global' : 'project';
   console.log(`Configuring ${scopeLabel} settings...`);

package/src/mcp-setup.mjs

@@ -17,18 +17,17 @@ export function getMcpServers(tokens) {
   if (tokens.stitchApiKey) {
     servers.stitch = {
       command: 'npx',
-      args: ['-y', '@_davideast/stitch-mcp'],
-      env: { GOOGLE_API_KEY: tokens.stitchApiKey },
+      args: ['-y', '@_davideast/stitch-mcp', 'proxy'],
+      env: { STITCH_API_KEY: tokens.stitchApiKey },
     };
   }
 
   if (tokens.cloudflareToken && tokens.cloudflareAccountId) {
     servers.cloudflare = {
       command: 'npx',
-      args: ['-y', '@cloudflare/mcp-server-cloudflare'],
+      args: ['-y', '@cloudflare/mcp-server-cloudflare', 'run', tokens.cloudflareAccountId],
       env: {
         CLOUDFLARE_API_TOKEN: tokens.cloudflareToken,
-        CLOUDFLARE_ACCOUNT_ID: tokens.cloudflareAccountId,
       },
     };
   }

package/src/prompt.mjs

@@ -32,7 +32,7 @@ export async function promptForTokens() {
   try {
     const stitchApiKey = await ask(
       rl,
-      'Stitch MCP API Key (X-Goog-Api-Key value): '
+      'Stitch MCP API Key (STITCH_API_KEY value): '
     );
 
     const cloudflareToken = await ask(

package/src/templates.mjs

@@ -10,6 +10,14 @@ const FILE_COPIES = [
 
 const DIR_COPIES = ['scripts', 'fastlane', 'web'];
 
+const FIREBASE_COPIES = [
+  ['firebase/firestore.rules.template', 'backend/firestore.rules'],
+  ['firebase/storage.rules.template', 'backend/storage.rules'],
+  ['firebase/firebase.json.template', 'backend/firebase.json'],
+  ['firebase/firestore.indexes.json.template', 'backend/firestore.indexes.json'],
+  ['firebase/.firebaserc.template', 'backend/.firebaserc'],
+];
+
 function copyIfMissing(srcPath, destPath, label, isDirectory) {
   if (!existsSync(srcPath)) return;
   if (existsSync(destPath)) {
@@ -53,3 +61,13 @@ export function installCiTemplates(projectDir, packageDir) {
     );
   }
 }
+
+export function installFirebaseTemplates(projectDir, packageDir) {
+  console.log('Installing Firebase backend templates...');
+  const templateDir = join(packageDir, 'templates');
+  ensureDir(join(projectDir, 'backend'));
+
+  for (const [src, dest] of FIREBASE_COPIES) {
+    copyIfMissing(join(templateDir, src), join(projectDir, dest), dest, false);
+  }
+}

package/templates/CLAUDE.md.template

@@ -45,7 +45,7 @@ metadata:
     - en-US
 
 web:
-  domain: "yourapp.example.com"
+  domain: "yourapp-pages.pages.dev"  # *.pages.dev domain is sufficient, no custom DNS needed
   cloudflare_project_name: "yourapp-pages"
 ```
 
@@ -92,10 +92,11 @@ Intro offer types: FREE, PAY_AS_YOU_GO, PAY_UP_FRONT.
 ## Flutter Development Standards
 
 ### Architecture
-- BLoC/Cubit pattern for state management
+- **State management**: Riverpod (recommended) or BLoC/Cubit
 - Repository pattern for data access
-- Dependency injection via get_it + injectable
+- **Dependency injection**: Riverpod providers (recommended) or get_it + injectable
 - Feature-first folder structure
+- Code generation: build_runner + riverpod_generator (or freezed + json_serializable)
 
 ### Folder Structure
 ```
@@ -111,9 +112,11 @@ lib/
     widgets/              # Shared widgets
   features/
     {feature}/
-      data/               # Data sources, repositories
-      domain/             # Entities, use cases
-      presentation/       # Screens, widgets, cubits
+      models/             # Data classes, entities
+      providers/          # Riverpod providers (or cubits/)
+      repositories/       # Data sources, API calls
+      screens/            # Full-page widgets
+      widgets/            # Feature-specific widgets
   services/
     firebase/
     api/
@@ -137,7 +140,17 @@ lib/
 - No TODO/FIXME in committed code
 - No hardcoded secrets anywhere
 
-### Dependencies (standard set)
+### Dependencies
+
+**Riverpod stack (recommended):**
+- flutter_riverpod + riverpod_annotation + riverpod_generator -- state management & DI
+- go_router -- navigation
+- dio -- HTTP client
+- freezed + json_serializable -- data classes
+- firebase_core, firebase_auth, cloud_firestore -- Firebase
+- purchases_flutter -- RevenueCat for IAP (or in_app_purchase)
+
+**BLoC stack (alternative):**
 - flutter_bloc / bloc -- state management
 - go_router -- navigation
 - get_it + injectable -- dependency injection
@@ -177,7 +190,7 @@ lib/
 
 ### Phase 1: Design
 1. Use designer agent to create UI/UX specs
-2. Use appstore-media-designer to plan screenshot strategy
+2. Plan screenshot strategy for all required device sizes
 3. Review designs before implementation
 
 ### Phase 2: Develop
@@ -186,32 +199,48 @@ lib/
 3. Fill ci.config.yaml with real values
 4. Add creds/AuthKey.p8 (Apple) and creds/play-service-account.json (Google)
 
-### Phase 3: Store Metadata
+### Phase 3: Store Metadata + Texts
 1. Run appstore-meta-creator to generate all metadata texts for configured languages
-2. Run appstore-media-designer to create screenshots for all device sizes
-3. Fill fastlane/iap_config.json if the app has subscriptions or IAP
-4. Run appstore-reviewer to verify full compliance
-
-### Phase 4: Web Pages
-1. Customize marketing landing page (web/marketing.html)
+2. Fill fastlane/iap_config.json if the app has subscriptions or IAP
+
+### Phase 4: Screenshots and App Media (MUST use Stitch MCP)
+Create all store screenshots and promotional images BEFORE web pages. The marketing page needs these images.
+
+1. **Use Stitch MCP** to design all visual assets. Stitch MCP is a design tool available via MCP -- use it for all image creation
+2. Run appstore-media-designer agent which will use Stitch MCP to create:
+   - App Store screenshots: 5 per device (iPhone 6.7", iPhone 6.5", iPad 12.9")
+   - Google Play screenshots: 5 per device (Phone, 7" Tablet, 10" Tablet)
+   - App Store promotional banner (optional)
+   - Google Play feature graphic (1024x500, required)
+3. Save all screenshots to `fastlane/metadata/en-US/screenshots/` (iOS) and `fastlane/metadata/android/en-US/images/` (Android)
+4. Each screenshot should have:
+   - Real app UI (capture from simulator via mobile-mcp, or design via Stitch MCP)
+   - Headline text overlay describing the feature shown
+   - Consistent branding (colors, fonts matching the app theme)
+5. Run appstore-reviewer to verify full compliance with store guidelines
+
+### Phase 5: Web Pages (after screenshots are ready)
+1. Customize marketing landing page (web/marketing.html) -- **include app screenshots** from Phase 4
 2. Customize privacy policy page (web/privacy.html)
 3. Customize terms of service page (web/terms.html)
 4. Customize support page (web/support.html)
-5. Deploy all via Cloudflare Pages (node web/deploy-cloudflare.mjs)
+5. **Use Stitch MCP** to design any additional web graphics, hero images, or promotional visuals
+6. Deploy all via Cloudflare Pages (node web/deploy-cloudflare.mjs)
+7. The default `*.pages.dev` domain is sufficient -- no custom DNS records needed. Use the generated URL (e.g., `yourapp-pages.pages.dev`) for privacy_url, support_url, and marketing_url in store metadata
 
-### Phase 5: CI/CD Setup
+### Phase 6: CI/CD Setup
 1. Run scripts/generate.sh to create codemagic.yaml from ci.config.yaml
 2. Commit all files to the private repository
 3. Push to GitHub
 4. Codemagic builds and deploys automatically on push to main
 
-### Phase 6: First Publish
+### Phase 7: First Publish
 - **iOS**: fully automated from first push -- builds, signs, uploads metadata + screenshots + binary
 - **Android**: first build creates AAB + HOW_TO_GOOGLE_PLAY.md artifact
   - Complete the manual steps listed in HOW_TO_GOOGLE_PLAY.md via Play Console
   - Push again for full automation on subsequent builds
 
-### Phase 7: Ongoing Updates
+### Phase 8: Ongoing Updates
 - Edit code, metadata, or screenshots as needed
 - Push to main branch
 - Codemagic detects what changed and only uploads modified assets

package/templates/analysis_options.yaml.template

@@ -0,0 +1,40 @@
+include: package:flutter_lints/flutter.yaml
+
+linter:
+  rules:
+    # Style
+    always_declare_return_types: true
+    prefer_const_constructors: true
+    prefer_const_declarations: true
+    prefer_single_quotes: true
+    require_trailing_commas: true
+    sort_child_properties_last: true
+
+    # Safety
+    avoid_print: true
+    unawaited_futures: true
+    use_build_context_synchronously: true
+    cancel_subscriptions: true
+    close_sinks: true
+
+    # Best practices
+    avoid_empty_else: true
+    avoid_relative_lib_imports: true
+    prefer_final_fields: true
+    prefer_final_locals: true
+    prefer_is_empty: true
+    prefer_is_not_empty: true
+    unnecessary_await_in_return: true
+    unnecessary_const: true
+    unnecessary_new: true
+    unnecessary_this: true
+
+analyzer:
+  errors:
+    missing_return: error
+    unawaited_futures: warning
+    avoid_print: warning
+  exclude:
+    - "**/*.g.dart"
+    - "**/*.freezed.dart"
+    - "**/*.gen.dart"

package/templates/ci.config.yaml.template

@@ -38,7 +38,7 @@ metadata:
 
 # === WEB PAGES ===
 web:
-  domain: "yourapp.example.com"
+  domain: "yourapp-pages.pages.dev"  # *.pages.dev domain is sufficient, no custom DNS needed
   cloudflare_project_name: "yourapp-pages"
   tagline: "Your app tagline here"
   primary_color: "#2563EB"

package/templates/fastlane/android/Gemfile.template

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+gem "fastlane"
+
+plugins_path = File.join(File.dirname(__FILE__), 'Pluginfile')
+eval_gemfile(plugins_path) if File.exist?(plugins_path)

package/templates/fastlane/ios/Gemfile.template

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+gem "fastlane"
+
+plugins_path = File.join(File.dirname(__FILE__), 'Pluginfile')
+eval_gemfile(plugins_path) if File.exist?(plugins_path)

package/templates/firebase/.firebaserc.template

@@ -0,0 +1,5 @@
+{
+  "projects": {
+    "default": "YOUR_FIREBASE_PROJECT_ID"
+  }
+}

package/templates/firebase/firebase.json.template

@@ -0,0 +1,16 @@
+{
+  "firestore": {
+    "rules": "firestore.rules",
+    "indexes": "firestore.indexes.json"
+  },
+  "functions": [
+    {
+      "source": "functions",
+      "codebase": "default",
+      "ignore": ["node_modules", ".git", "firebase-debug.log", "firebase-debug.*.log", "*.local"]
+    }
+  ],
+  "storage": {
+    "rules": "storage.rules"
+  }
+}

package/templates/firebase/firestore.indexes.json.template

@@ -0,0 +1,4 @@
+{
+  "indexes": [],
+  "fieldOverrides": []
+}

package/templates/firebase/firestore.rules.template

@@ -0,0 +1,20 @@
+rules_version = '2';
+service cloud.firestore {
+  match /databases/{database}/documents {
+    function isOwner(userId) {
+      return request.auth != null && request.auth.uid == userId;
+    }
+
+    match /users/{userId} {
+      allow read, write: if isOwner(userId);
+
+      match /{subcollection=**} {
+        allow read, write: if isOwner(userId);
+      }
+    }
+
+    match /system/{document=**} {
+      allow read, write: if false;
+    }
+  }
+}

package/templates/firebase/storage.rules.template

@@ -0,0 +1,10 @@
+rules_version = '2';
+service firebase.storage {
+  match /b/{bucket}/o {
+    match /users/{userId}/{allPaths=**} {
+      allow read, write: if request.auth != null
+                         && request.auth.uid == userId
+                         && request.resource.size < 10 * 1024 * 1024;
+    }
+  }
+}

package/templates/scripts/generate.sh

@@ -27,6 +27,18 @@ if ! command -v yq &>/dev/null; then
   exit 1
 fi
 
+# Validate that a config value does not contain characters that break sed
+validate_value() {
+  local name="$1"
+  local value="$2"
+  if [[ "$value" =~ [|/\\] ]]; then
+    echo "ERROR: $name contains invalid characters (|, /, or \\) that would break substitution."
+    echo "  Current value: $value"
+    echo "  Please remove |, /, and \\ characters from $name in $CONFIG"
+    exit 1
+  fi
+}
+
 # Read app values from ci.config.yaml
 BUNDLE_ID=$(yq -r '.app.bundle_id' "$CONFIG")
 PACKAGE_NAME=$(yq -r '.app.package_name' "$CONFIG")
@@ -49,6 +61,18 @@ APPLE_ISSUER_ID=$(yq -r '.credentials.apple.issuer_id' "$CONFIG")
 GOOGLE_SA_JSON_PATH=$(yq -r '.credentials.google.service_account_json_path' "$CONFIG")
 KEYSTORE_PASSWORD=$(yq -r '.credentials.android.keystore_password' "$CONFIG")
 
+# Validate all values before sed substitution
+validate_value "app.bundle_id" "$BUNDLE_ID"
+validate_value "app.package_name" "$PACKAGE_NAME"
+validate_value "app.name" "$APP_NAME"
+validate_value "app.sku" "$SKU"
+validate_value "app.apple_id" "$APPLE_ID"
+validate_value "android.track" "$TRACK"
+validate_value "ios.primary_category" "$PRIMARY_CAT"
+validate_value "ios.secondary_category" "$SECONDARY_CAT"
+validate_value "credentials.apple.key_id" "$APPLE_KEY_ID"
+validate_value "credentials.apple.issuer_id" "$APPLE_ISSUER_ID"
+
 # Generate codemagic.yaml from template
 sed \
   -e "s|\${BUNDLE_ID}|$BUNDLE_ID|g" \

package/templates/web/deploy-cloudflare.mjs

@@ -79,9 +79,17 @@ function getCredentials(dir) {
     const mcpPath = join(dir, ".mcp.json");
     if (existsSync(mcpPath)) {
       const mcp = JSON.parse(readFileSync(mcpPath, "utf8"));
-      const cf = mcp?.mcpServers?.cloudflare?.env || {};
-      token = token || cf.CLOUDFLARE_API_TOKEN || "";
-      accountId = accountId || cf.CLOUDFLARE_ACCOUNT_ID || "";
+      const cfServer = mcp?.mcpServers?.cloudflare || {};
+      const cfEnv = cfServer.env || {};
+      const cfArgs = cfServer.args || [];
+      token = token || cfEnv.CLOUDFLARE_API_TOKEN || "";
+      if (!accountId && cfArgs.length >= 4) {
+        const runIdx = cfArgs.indexOf("run");
+        if (runIdx >= 0 && cfArgs[runIdx + 1]) {
+          accountId = cfArgs[runIdx + 1];
+        }
+      }
+      accountId = accountId || cfEnv.CLOUDFLARE_ACCOUNT_ID || "";
     }
   }
   if (!token || !accountId) {