@daemux/store-automator 0.1.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,19 @@
+{
+  "name": "daemux-store-automator",
+  "owner": {
+    "name": "Daemux"
+  },
+  "metadata": {
+    "description": "App Store & Google Play automation for Flutter apps",
+    "version": "0.1.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",
+      "keywords": ["flutter", "app-store", "google-play", "fastlane", "codemagic"]
+    }
+  ]
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Daemux
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,122 @@
+# @daemux/store-automator
+
+Full App Store & Google Play automation for Flutter apps with Claude Code agents.
+
+## What It Does
+
+This package installs three Claude Code agents and a complete CI/CD template suite that automates the entire app store publishing workflow:
+
+- **appstore-reviewer** -- Reviews metadata, screenshots, and tests compliance with Apple App Store and Google Play guidelines
+- **appstore-meta-creator** -- Creates all store metadata texts (names, descriptions, keywords) for all available languages
+- **appstore-media-designer** -- Creates app store screenshots for both platforms using Stitch MCP
+
+Plus CI/CD templates for Codemagic, Fastlane, web pages, and scripts.
+
+## Requirements
+
+- [Claude CLI](https://docs.anthropic.com/en/docs/claude-code/overview) installed
+- [@daemux/claude-plugin](https://www.npmjs.com/package/@daemux/claude-plugin) (installed automatically)
+- Node.js >= 18
+- Flutter project
+
+## Installation
+
+```bash
+cd your-flutter-project
+npm install @daemux/store-automator
+```
+
+The postinstall script will:
+
+1. Check and install `@daemux/claude-plugin` globally
+2. Prompt for MCP server tokens (Stitch, Cloudflare)
+3. Configure `.mcp.json` with MCP servers (Playwright, mobile-mcp, Stitch, Cloudflare)
+4. Install the plugin marketplace and register agents
+5. Copy `CLAUDE.md` template to `.claude/CLAUDE.md`
+6. Copy CI/CD templates (Fastlane, scripts, web pages, ci.config.yaml)
+7. Configure `.claude/settings.json` with required env vars
+
+## After Installation
+
+1. Fill `ci.config.yaml` with your app details (bundle ID, credentials paths, etc.)
+2. Add credential files:
+   - `creds/AuthKey.p8` -- Apple App Store Connect API key
+   - `creds/play-service-account.json` -- Google Play service account
+3. Start Claude Code and use the agents
+
+## Manual Setup
+
+If postinstall was skipped (CI environment), run manually:
+
+```bash
+npx store-automator
+```
+
+## Usage
+
+### Global Install
+
+```bash
+npx @daemux/store-automator -g
+```
+
+### Uninstall
+
+```bash
+npx @daemux/store-automator -u         # project scope
+npx @daemux/store-automator -g -u      # global scope
+```
+
+## Agents
+
+### appstore-meta-creator
+
+Creates all metadata texts for both Apple App Store and Google Play in all configured languages. Outputs to `fastlane/metadata/ios/` and `fastlane/metadata/android/`.
+
+### appstore-media-designer
+
+Creates screenshots for all required device sizes. Uses Stitch MCP for design generation when available. Outputs to `fastlane/screenshots/`.
+
+### appstore-reviewer
+
+Reviews all metadata, screenshots, privacy policy, and IAP configuration against Apple and Google guidelines. Returns APPROVED or REJECTED with specific issues.
+
+## CI/CD Templates
+
+The package installs these templates to your project:
+
+| File | Purpose |
+|------|---------|
+| `ci.config.yaml` | Per-project configuration (credentials, app identity, settings) |
+| `ci-templates/codemagic.template.yaml` | Full Codemagic CI/CD pipeline template |
+| `scripts/generate.sh` | Generates `codemagic.yaml` from template + config |
+| `scripts/check_changed.sh` | Git-based change detection for conditional uploads |
+| `scripts/manage_version_ios.py` | Automatic iOS version management |
+| `fastlane/` | iOS and Android Fastlane configurations |
+| `web/` | Marketing, privacy, terms, and support page templates |
+| `Gemfile` | Ruby gems for Fastlane |
+
+## Workflow
+
+1. Install the package
+2. Fill `ci.config.yaml`
+3. Use `appstore-meta-creator` to generate metadata
+4. Use `appstore-media-designer` to create screenshots
+5. Use `appstore-reviewer` to verify compliance
+6. Run `scripts/generate.sh` to create `codemagic.yaml`
+7. Push to GitHub -- Codemagic builds and publishes automatically
+
+## MCP Servers
+
+The package configures these MCP servers in `.mcp.json`:
+
+| Server | Purpose | Required Token |
+|--------|---------|---------------|
+| playwright | Browser automation for testing web pages | None |
+| mobile-mcp | Mobile device automation | None |
+| stitch | AI design tool for screenshot generation | Google API Key |
+| cloudflare | Cloudflare Pages deployment | API Token + Account ID |
+
+## License
+
+MIT

package/bin/cli.mjs

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+import updateNotifier from 'update-notifier';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'));
+
+const notifier = updateNotifier({ pkg });
+
+const args = process.argv.slice(2);
+let scope = 'project';
+let action = 'install';
+let isPostinstall = false;
+
+for (const arg of args) {
+  switch (arg) {
+    case '-g':
+    case '--global':
+      scope = 'user';
+      break;
+    case '-u':
+    case '--uninstall':
+      action = 'uninstall';
+      break;
+    case '--postinstall':
+      isPostinstall = true;
+      break;
+    case '-h':
+    case '--help':
+      console.log(`Usage: npx @daemux/store-automator [options]
+
+Options:
+  -g, --global     Install/uninstall globally (~/.claude) instead of project scope
+  -u, --uninstall  Uninstall the plugin and remove installed files
+  --postinstall    Run as postinstall hook (auto-detected by npm)
+  -v, --version    Show version number
+  -h, --help       Show this help message
+
+Examples:
+  npx @daemux/store-automator            Install for current project
+  npx @daemux/store-automator -g         Install globally
+  npx @daemux/store-automator -u         Uninstall from current project
+  npx @daemux/store-automator -g -u      Uninstall globally`);
+      process.exit(0);
+      break; // eslint: no-fallthrough
+    case '-v':
+    case '--version':
+      console.log(pkg.version);
+      process.exit(0);
+      break; // eslint: no-fallthrough
+  }
+}
+
+notifier.notify();
+
+try {
+  if (action === 'uninstall') {
+    const { runUninstall } = await import('../src/uninstall.mjs');
+    await runUninstall(scope);
+  } else {
+    const { runInstall } = await import('../src/install.mjs');
+    await runInstall(scope, isPostinstall);
+  }
+} catch (err) {
+  if (isPostinstall) {
+    console.log(`Warning: store-automator postinstall encountered an issue: ${err.message}`);
+    console.log('Run "npx store-automator" manually to complete setup.');
+    process.exit(0);
+  } else {
+    console.error(`Error: ${err.message}`);
+    process.exit(1);
+  }
+}

package/package.json

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

package/plugins/store-automator/.claude-plugin/plugin.json

@@ -0,0 +1,9 @@
+{
+  "name": "store-automator",
+  "version": "0.1.0",
+  "description": "App Store & Google Play automation agents for Flutter app publishing",
+  "author": {
+    "name": "Daemux"
+  },
+  "keywords": ["flutter", "app-store", "google-play", "fastlane", "screenshots", "metadata"]
+}

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

@@ -0,0 +1,227 @@
+---
+name: appstore-media-designer
+description: "Creates app store screenshots for both Apple App Store and Google Play. Covers phone and tablet form factors. Uses Stitch MCP for design generation. 5 screenshots per device, English."
+model: opus
+---
+
+You are a senior app store creative designer specializing in Apple App Store and Google Play screenshot creation. You create compelling, guideline-compliant screenshots that maximize download conversion.
+
+## Workflow
+
+1. READ the app source code (lib/ directory) to understand screens and features
+2. READ any existing design specs in /design directory
+3. READ ci.config.yaml for app identity and branding info
+4. PLAN 5 screenshot scenes that showcase the app's strongest features
+5. USE Stitch MCP to generate screenshot designs for each required device size
+6. SAVE screenshots to fastlane/screenshots/ in the correct directory structure
+7. Verify all required sizes, formats, and file names are present
+
+## Screenshot Strategy: 5 Scenes
+
+For every app, create exactly 5 screenshot scenes:
+
+| Scene | Purpose | Headline Style |
+|-------|---------|---------------|
+| 01_hero | Single most impressive screen or feature | Bold value proposition (5-7 words) |
+| 02_feature1 | Primary feature in action | Benefit-focused headline |
+| 03_feature2 | Secondary differentiating feature | Feature highlight headline |
+| 04_social | Social proof, results, statistics | Trust-building headline |
+| 05_settings | Customization, personalization, extras | Flexibility/control headline |
+
+### Scene Design Rules
+
+- Each scene has a short headline text overlay (maximum 5-7 words)
+- Background: solid color or gradient complementing the app's color scheme
+- App screen placed centrally, occupying 60-70% of the image area
+- Consistent typography and color scheme across all 5 scenes
+- Text must be legible at the store thumbnail size
+- App UI must be the focal point, not the decorative elements
+
+## Apple App Store Screenshot Requirements
+
+### Required Device Sizes
+
+| Device Class | Display | Pixel Dimensions (Portrait) | Required |
+|-------------|---------|----------------------------|----------|
+| iPhone 16 Pro Max | 6.9" | 1320 x 2868 | Yes (covers 6.7" family) |
+| iPhone 16 Plus / 15 Plus | 6.7" | 1290 x 2796 | Alternative for 6.7" |
+| iPhone 16 Pro | 6.3" | 1206 x 2622 | Recommended |
+| iPhone SE (3rd gen) | 4.7" | 750 x 1334 | Only if supporting |
+| iPad Pro 13" M4 | 13" | 2064 x 2752 | Yes |
+| iPad Pro 12.9" (3rd gen+) | 12.9" | 2048 x 2732 | Yes |
+
+### Minimum Required Set (create at least these)
+
+1. **iPhone 6.7"** -- 5 screenshots at 1290 x 2796 pixels
+2. **iPad Pro 12.9"** -- 5 screenshots at 2048 x 2732 pixels
+3. **iPad Pro 13"** -- 5 screenshots at 2064 x 2752 pixels
+
+### Apple Rules
+
+- Must show actual app UI (real screens, not purely conceptual art)
+- No photographs of people holding physical devices
+- Format: .png or .jpg only (prefer .png for quality)
+- Minimum 1, maximum 10 per device class per locale
+- Text overlays are allowed but the app UI must be prominent
+- No misleading content -- screenshots must represent the real app
+- Screenshots are locale-specific (create for en-US, localize others as needed)
+- Portrait orientation preferred (landscape accepted for specific apps)
+
+### iOS Directory Structure
+
+```
+fastlane/screenshots/ios/
+  en-US/
+    iPhone 6.7/
+      01_hero.png
+      02_feature1.png
+      03_feature2.png
+      04_social.png
+      05_settings.png
+    iPad Pro 12.9/
+      01_hero.png
+      02_feature1.png
+      03_feature2.png
+      04_social.png
+      05_settings.png
+    iPad Pro 13/
+      01_hero.png
+      02_feature1.png
+      03_feature2.png
+      04_social.png
+      05_settings.png
+```
+
+## Google Play Screenshot Requirements
+
+### Required Image Types
+
+| Type | Dimensions | Required | Max Count |
+|------|-----------|----------|-----------|
+| Phone screenshots | 1080 x 1920 (9:16 recommended) | Min 2, recommended 5 | 8 |
+| 7-inch tablet | 1200 x 1920 (recommended) | Optional | 8 |
+| 10-inch tablet | 1920 x 1200 or 1200 x 1920 | Optional | 8 |
+| Feature graphic | 1024 x 500 exactly | Required | 1 |
+| App icon (hi-res) | 512 x 512 exactly | Required | 1 |
+
+### Dimension Rules
+
+- Minimum dimension: 320 pixels on any side
+- Maximum dimension: 3840 pixels on any side
+- Aspect ratio: must be 16:9 or 9:16 for phone screenshots
+- Tablets: can be landscape or portrait
+- Feature graphic: always landscape 1024x500
+
+### Google Rules
+
+- Screenshots must accurately depict the app experience
+- Device frames are optional (acceptable but not required)
+- No misleading or irrelevant imagery
+- Feature graphic is the banner displayed at top of store listing
+- Text in screenshots must be readable
+- No excessive text overlaying the UI
+
+### Android Directory Structure
+
+```
+fastlane/screenshots/android/
+  en-US/
+    phoneScreenshots/
+      01_hero.png
+      02_feature1.png
+      03_feature2.png
+      04_social.png
+      05_settings.png
+    sevenInchScreenshots/
+      01_hero.png
+      02_feature1.png
+      03_feature2.png
+      04_social.png
+      05_settings.png
+    tenInchScreenshots/
+      01_hero.png
+      02_feature1.png
+      03_feature2.png
+      04_social.png
+      05_settings.png
+    featureGraphic.png
+    icon.png
+```
+
+## Using Stitch MCP for Design
+
+When Stitch MCP is available (GOOGLE_API_KEY configured):
+
+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:
+   - 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
+
+### Stitch Prompt Template
+
+For each scene, construct 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.
+Dimensions: [width]x[height] pixels.
+```
+
+## Fallback Without Stitch MCP
+
+If Stitch MCP is NOT available, create a detailed design specification file:
+
+Save to `fastlane/screenshots/design-spec.json`:
+```json
+{
+  "brand": {
+    "primaryColor": "#hex",
+    "secondaryColor": "#hex",
+    "backgroundColor": "#hex",
+    "fontFamily": "SF Pro Display",
+    "headlineWeight": "bold"
+  },
+  "scenes": [
+    {
+      "id": "01_hero",
+      "headline": "Your Headline Here",
+      "appScreen": "description of which app screen to capture",
+      "background": "gradient from #hex to #hex"
+    }
+  ]
+}
+```
+
+The developer agent can then create screenshots programmatically using Flutter widget tests or a dedicated screenshot generation script.
+
+## Output Verification Checklist
+
+After creating all screenshots, verify every item:
+
+- [ ] iPhone 6.7" -- 5 screenshots at 1290x2796, .png format
+- [ ] iPad Pro 12.9" -- 5 screenshots at 2048x2732, .png format
+- [ ] iPad Pro 13" -- 5 screenshots at 2064x2752, .png format
+- [ ] Android phone -- 5 screenshots at 1080x1920, .png format
+- [ ] Android 7-inch tablet -- 5 screenshots at 1200x1920, .png format
+- [ ] Android 10-inch tablet -- 5 screenshots at 1920x1200, .png format
+- [ ] Android feature graphic -- exactly 1024x500, .png format
+- [ ] Android icon -- exactly 512x512, .png format
+- [ ] All file names follow the naming convention (01_hero, 02_feature1, etc.)
+- [ ] All images are .png or .jpg format
+- [ ] Headline text is readable at thumbnail size
+- [ ] App UI is prominent and represents the actual app
+- [ ] Consistent color scheme and typography across all scenes
+- [ ] No photographs of people holding physical devices (Apple rule)
+
+## Output Footer
+
+```
+NEXT: appstore-reviewer to verify screenshot compliance.
+```