@agustin-perticaro/store-pilot 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Agustin Perticaro
+
+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,209 @@
+# store-pilot
+
+CLI to automate ASO, builds, and store uploads for Expo/React Native projects **without EAS**.
+
+One command to do it all: keywords → screenshots → build → upload.
+
+---
+
+## Installation
+
+```bash
+npm install -g store-pilot
+```
+
+Requires Node.js ≥ 18, Ruby + Bundler, and fastlane installed.
+
+```bash
+gem install fastlane
+```
+
+---
+
+## Setup (once per project)
+
+```bash
+cd your-expo-project
+store-pilot init
+```
+
+`init` auto-detects your `app.json`, asks questions, and generates:
+
+- `fastlane/Appfile` — identifies your app
+- `fastlane/Fastfile` — all automated lanes
+- `fastlane/Matchfile` — iOS certificate management
+- `fastlane/metadata/` — complete structure per language
+- `.env.store-pilot` — your credentials (DO NOT commit)
+- `.env.store-pilot.example` — safe template for the repo
+- `store-pilot-scripts/` — standalone scripts
+
+### Configure iOS certificates (once)
+
+```bash
+store-pilot match-setup
+```
+
+Uses fastlane match: creates and stores your certificates in a private git repo. Any team Mac can sync them with `bundle exec fastlane match appstore --readonly`.
+
+---
+
+## Required Credentials
+
+Fill in `.env.store-pilot` with:
+
+| Variable | Where to get it |
+|---|---|
+| `ASC_KEY_ID` | App Store Connect → Users → API Keys |
+| `ASC_ISSUER_ID` | Same page |
+| `ASC_KEY_PATH` | The downloaded `.p8` file |
+| `MATCH_PASSWORD` | Password you chose in match-setup |
+| `GOOGLE_PLAY_JSON_KEY_PATH` | Play Console → Settings → API Access → Service Account |
+| `ANDROID_KEYSTORE_*` | Your release keystore |
+| `APPSCREENS_API_KEY` | appscreens.io → Account → API |
+| `APPSCREENS_PROJECT_ID` | Your AppScreens project ID |
+
+---
+
+## Usage
+
+### Full pipeline (recommended)
+
+```bash
+store-pilot ship
+```
+
+Runs in order: expo prebuild → keywords → screenshots → build iOS + Android → upload.
+
+```bash
+# iOS only, submit for review automatically
+store-pilot ship --platform ios --submit
+
+# Android only, upload to beta
+store-pilot ship --platform android --track beta
+
+# Skip keywords and screenshots (if unchanged)
+store-pilot ship --skip-keywords --skip-screenshots
+```
+
+### Individual commands
+
+```bash
+# Update keywords from Astro MCP
+store-pilot keywords
+
+# New app not published yet → use a competitor as reference
+store-pilot keywords --competitor "https://apps.apple.com/app/notion/id1232780281"
+
+# Generate and download screenshots from AppScreens
+store-pilot screenshots
+
+# Generate AND upload directly to stores
+store-pilot screenshots --upload
+```
+
+---
+
+## Workflow for new apps (pre-publication)
+
+Astro works before publishing by using competitors as proxy:
+
+1. Find 2-3 competitor apps in the App Store
+2. Copy their URLs
+3. Run for each one:
+   ```bash
+   store-pilot keywords --competitor "https://apps.apple.com/app/.../id123"
+   ```
+4. store-pilot combines and ranks keywords by popularity/difficulty
+
+---
+
+## Metadata
+
+Fill in the files at `fastlane/metadata/` — plain text files versioned in git:
+
+```
+fastlane/metadata/
+├── ios/
+│   ├── en-US/
+│   │   ├── name.txt               ← app name
+│   │   ├── subtitle.txt           ← subtitle (30 chars)
+│   │   ├── description.txt        ← long description
+│   │   ├── keywords.txt           ← generated by store-pilot keywords
+│   │   ├── promotional_text.txt   ← updatable without new build
+│   │   └── release_notes.txt      ← what's new in this version
+│   └── review_information/
+│       ├── first_name.txt
+│       └── ...
+└── android/
+    └── en-US/
+        ├── title.txt
+        ├── short_description.txt
+        ├── full_description.txt
+        └── changelogs/
+            └── default.txt
+```
+
+---
+
+## CI/CD (GitHub Actions)
+
+```yaml
+# .github/workflows/ship.yml
+name: Ship to stores
+
+on:
+  push:
+    tags: ['v*']
+
+jobs:
+  ship:
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+      - run: npm install -g store-pilot
+      - run: gem install fastlane
+      - run: store-pilot ship --skip-keywords
+        env:
+          ASC_KEY_ID: ${{ secrets.ASC_KEY_ID }}
+          ASC_ISSUER_ID: ${{ secrets.ASC_ISSUER_ID }}
+          ASC_KEY_PATH: ${{ secrets.ASC_KEY_PATH }}
+          MATCH_PASSWORD: ${{ secrets.MATCH_PASSWORD }}
+          GOOGLE_PLAY_JSON_KEY_PATH: ${{ secrets.GOOGLE_PLAY_JSON_KEY }}
+          ANDROID_KEYSTORE_PATH: ${{ secrets.ANDROID_KEYSTORE }}
+          ANDROID_KEYSTORE_PASS: ${{ secrets.ANDROID_KEYSTORE_PASS }}
+          ANDROID_KEY_ALIAS: ${{ secrets.ANDROID_KEY_ALIAS }}
+          ANDROID_KEY_PASS: ${{ secrets.ANDROID_KEY_PASS }}
+          APPSCREENS_API_KEY: ${{ secrets.APPSCREENS_API_KEY }}
+          APPSCREENS_PROJECT_ID: ${{ secrets.APPSCREENS_PROJECT_ID }}
+```
+
+> **Note:** `store-pilot keywords` uses Astro MCP which runs locally on your Mac, so that step is done on your machine before pushing. In CI it's skipped with `--skip-keywords`.
+
+---
+
+## Project structure
+
+```
+store-pilot/
+├── bin/store-pilot.js      CLI entrypoint
+├── commands/
+│   ├── init.js             scaffolding
+│   ├── keywords.js         Astro MCP → keywords.txt
+│   ├── screenshots.js      AppScreens API → assets
+│   ├── ship.js             full pipeline
+│   └── match-setup.js      certificate setup
+├── lib/
+│   └── config.js           config + env loader
+└── templates/
+    ├── scripts/             copied to project as store-pilot-scripts/
+    └── fastlane/metadata/   base metadata structure
+```
+
+---
+
+## License
+
+MIT

package/bin/store-pilot.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+import { program } from 'commander';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, '../package.json'), 'utf8'));
+
+program
+  .name('store-pilot')
+  .description('Automate ASO, builds & store uploads for Expo/React Native projects')
+  .version(pkg.version);
+
+program
+  .command('init')
+  .description('Configure store-pilot in an existing Expo project')
+  .option('--yes', 'Saltar confirmaciones interactivas')
+  .action(async (opts) => {
+    const { runInit } = await import('../commands/init.js');
+    await runInit(opts);
+  });
+
+program
+  .command('keywords')
+  .description('Generate keywords.txt from Astro MCP (must be running)')
+  .option('--lang <lang>', 'Target language (e.g. en-US)', 'en-US')
+  .option('--min-popularity <n>', 'Minimum popularity', '20')
+  .option('--max-difficulty <n>', 'Maximum difficulty', '50')
+  .option('--competitor <url>', 'App Store URL of a competitor to extract keywords from')
+  .action(async (opts) => {
+    const { runKeywords } = await import('../commands/keywords.js');
+    await runKeywords(opts);
+  });
+
+program
+  .command('screenshots')
+  .description('Generate and download screenshots from AppScreens API')
+  .option('--upload', 'Upload directly to App Store Connect and Google Play')
+  .action(async (opts) => {
+    const { runScreenshots } = await import('../commands/screenshots.js');
+    await runScreenshots(opts);
+  });
+
+program
+  .command('ship')
+  .description('Full pipeline: keywords → screenshots → build → upload')
+  .option('--platform <p>', 'ios | android | all', 'all')
+  .option('--track <t>', 'Android track: internal | alpha | beta | production', 'internal')
+  .option('--submit', 'Submit for review automatically (iOS)')
+  .option('--skip-keywords', 'Skip keyword update')
+  .option('--skip-screenshots', 'Skip screenshot regeneration')
+  .action(async (opts) => {
+    const { runShip } = await import('../commands/ship.js');
+    await runShip(opts);
+  });
+
+program
+  .command('match-setup')
+  .description('Configure fastlane match for automatic iOS certificate management')
+  .action(async () => {
+    const { runMatchSetup } = await import('../commands/match-setup.js');
+    await runMatchSetup();
+  });
+
+program.parse();