Mobile Repo Doctor

Health scanner for Android, iOS, Flutter, and KMP repositories. Analyzes size, speed, stability, and hygiene — 50+ checks, actionable report in seconds.

Install

npm install -g mobile-repo-doctor

Usage

# Scan a project
mrd scan ./my-app

# Generate HTML report and open in browser
mrd scan ./my-app -f html --open

# JSON output
mrd scan ./my-app -f json -o report.json

# Both formats
mrd scan ./my-app -f html,json

mrd is a shortcut for mobile-repo-doctor.

What it checks

| Axis | Examples | |------|---------| | Size | Oversized assets, duplicates, heavy fonts, unoptimized PNGs | | Speed | Dependency health, build config, optimization flags | | Stability | Config drift, manifest anomalies, platform hardening | | Hygiene | Sensitive files, generated code, project structure |

CLI Options

mrd scan [options] <path>

Options:
  -o, --output <path>   Output file path (default: "./repo-health-report.html")
  -f, --format <type>   Report format: html, json, or html,json (default: "html")
  --open                Open report in browser after generation
  -v, --verbose         Verbose output
  --api-key <key>       API key for Pro features (or REPO_DOCTOR_API_KEY env)
  --no-telemetry        Disable usage reporting
  --offline             Use cached data only, no network calls

GitHub Action

- uses: Mavoryl/mobile-repo-doctor-action@v1
  with:
    fail-on: 'high'        # none | critical | high | score-below-70
    output: 'html,json'

See action docs for full options.

License

Mavoryl Source Available License — free to use and modify, commercial redistribution prohibited.