Mach CLI

Cloud Build Orchestrator for React Native & Expo

Mach is a powerful CLI that lets you build, sign, and submit React Native & Expo apps to the App Store and Google Play — all from the cloud. No more local build headaches.

Installation

npm install -g @radhya/mach

Quick Start

# Login to Mach Dashboard
mach login

# Initialize a project
mach init

# Link an existing project
mach link

# Run a cloud build
mach build --platform ios
mach build --platform android

Commands

| Command | Description | |---------|-------------| | mach login | Login to Mach Dashboard | | mach init | Create a new Mach project | | mach link | Link local directory to a Mach project | | mach me | Display current user details | | mach build | Run a cloud build (iOS / Android) | | mach submit | Automated store submission (App Store / Google Play) | | mach credentials | Interactive credential management (iOS / Android) | | mach env | Manage environment variables | | mach config | Show resolved configuration for a profile | | mach start | Start the development server (Metro) | | mach host | Setup AWS S3 static hosting with CloudFront | | mach sitemap | Generate sitemap.xml from Expo Router | | mach audit | Run automated security audit on the project |

Cloud Builds

Build your apps on cloud infrastructure using AWS Spot Instances — fast, cost-effective, and fully automated.

# iOS build
mach build --platform ios --profile production

# Android build
mach build --platform android --profile production

# Local build
mach build --platform ios --local

# Dry run (generate build script without launching)
mach build --platform android --dry-run

Build Options

• --platform <os> — Target platform: ios or android (required)
• --profile <name> — Build profile: production, staging, development
• --local — Run build on local machine
• --dry-run — Generate script without launching
• --verbose — Enable verbose logging
• --simulator — Build for iOS Simulator (no signing required)

Store Submission

Automate your App Store and Google Play submissions directly from the CLI.

# Submit to App Store
mach submit --platform ios

# Submit to Google Play (internal track)
mach submit --platform android --track internal

Credential Management

Manage iOS certificates, provisioning profiles, Android keystores, and service credentials — all in one place.

# Interactive credential manager
mach credentials

# Legacy: Automated provisioning
mach credentials:setup --platform ios
mach credentials:setup --platform android

# Upload service credentials (ASC API Key / Google Service JSON)
mach credentials:service --platform ios --file key.p8 --key-id XXXXX --issuer-id XXXXX

Configuration

Create a mach.config.json in your project root:

{
  "projectId": "your-project-id",
  "name": "MyApp",
  "slug": "my-app",
  "scheme": "myapp",
  "ios": {
    "bundleIdentifier": "com.example.myapp",
    "teamId": "XXXXXXXXXX"
  },
  "android": {
    "package": "com.example.myapp"
  }
}

Build Profiles

Define multiple build profiles for different environments:

{
  "projectId": "your-project-id",
  "profiles": {
    "development": {
      "ios": { "configuration": "Debug", "exportMethod": "development" }
    },
    "production": {
      "ios": { "configuration": "Release", "exportMethod": "app-store" }
    }
  }
}

Environment Variables

# Set environment variables
mach env set API_URL=https://api.example.com SECRET_KEY=xxx

# List all variables
mach env list

Development Server

# Start Metro with profile
mach start --build-profile development

# Start with tunnel
mach start --tunnel

# Clear cache
mach start --clear

Security Audit

Run automated security checks on your project:

mach audit
mach audit --severity high
mach audit --fix
mach audit --json  # CI/CD friendly output

Requirements

• Node.js 18+
• npm or yarn
• For iOS builds: Xcode (local) or cloud instance with macOS
• For Android builds: Android SDK (local) or cloud instance

License

ISC

Built by Radhya Softlabs