Stora

The intelligent mobile app deployment tool.

Features

• AI-Powered Screenshots - Agentic exploration of your app to capture App Store-ready screenshots
• Compliance Checking - Validate your app against App Store and Play Store guidelines
• AI Analysis - Uses Google Gemini for intelligent automation
• Cross-Platform - Works with iOS and Android apps
• Modular - Use individual packages or the full CLI

Quick Start

# Install globally
npm install -g stora-sh

# Capture screenshots (requires Maestro CLI and running simulator)
stora screenshots com.example.app --max-screenshots 10

# Check compliance
stora compliance ./my-app --platform ios

# Verify setup
stora doctor

Requirements

• Node.js 18+
• Maestro CLI - Install Maestro
• Google AI API Key - Set GOOGLE_GENERATIVE_AI_API_KEY environment variable
• Running iOS Simulator or Android Emulator with your app installed

CLI Commands

stora screenshots <bundleId>

Capture App Store-ready screenshots using AI-powered exploration.

stora screenshots com.example.app
stora screenshots com.example.app --max-screenshots 10 --output ./screenshots
stora screenshots com.example.app --max-steps 30 --model gemini-2.0-flash

Options: | Option | Default | Description | |--------|---------|-------------| | --max-steps <n> | 50 | Maximum exploration steps | | --max-screenshots <n> | 10 | Target number of screenshots | | --output <path> | ./store-screenshots | Output directory | | --save-eval | false | Save evaluation screenshots for debugging | | --model <model> | gemini-2.0-flash | AI model to use |

stora compliance [path]

Check your app for compliance issues before submission.

stora compliance ./my-app
stora compliance ./my-app --platform ios
stora compliance ./my-app --platform android --no-ai
stora compliance --strict

Options: | Option | Default | Description | |--------|---------|-------------| | -p, --platform <platform> | both | Target platform (ios, android, both) | | --no-ai | false | Disable AI-powered analysis | | --strict | false | Use strict checking mode |

stora doctor

Check if all dependencies are installed correctly.

stora doctor

Packages

Use the CLI for the full experience, or install individual packages for programmatic use:

| Package | Description | Install | |---------|-------------|---------| | stora-sh | Main CLI tool | npm i -g stora-sh | | @stora/screenshots | AI screenshot automation | npm i @stora/screenshots | | @stora/compliance | Compliance checking | npm i @stora/compliance | | @stora/shared | Shared utilities | npm i @stora/shared |

Environment Variables

# Required for AI features
export GOOGLE_GENERATIVE_AI_API_KEY=your-api-key

Development

# Clone the repo
git clone https://github.com/storasource/stora.git
cd stora

# Install dependencies
pnpm install

# Build all packages
pnpm build

# Run development mode
pnpm dev

Project Structure

stora/
├── apps/
│   └── cli/              # stora-sh CLI package
├── packages/
│   ├── screenshots/      # @stora/screenshots
│   ├── compliance/       # @stora/compliance
│   ├── shared/           # @stora/shared
│   ├── aso/              # @stora/aso (in development)
│   ├── analyzer/         # @stora/analyzer (in development)
│   ├── deployment/       # @stora/deployment (in development)
│   ├── build/            # @stora/build (in development)
│   └── assets/           # @stora/assets (in development)
├── docs/                 # Documentation
└── .github/workflows/    # CI/CD

License

MIT