Mobile Repo Doctor

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

📖 Documentation & full check reference: https://mavoryl.github.io/mobile-repo-doctor/

What you get

A standalone report with a health score (0–100), severity-ranked findings, and actionable fixes.

Top issues are sorted by severity with one-line summaries:

Each finding includes why it matters, impact, evidence (file paths, sizes), and a concrete fix:

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

# Markdown report optimized for AI/LLM analysis
mrd scan ./my-app -f md -o report.md

# Multiple formats at once
mrd scan ./my-app -f html,json,md

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, md (AI-friendly), or comma-separated (default: "html")
  --open                Open report in browser after generation
  -v, --verbose         Verbose output
  --no-update-check     Disable the npm update-available notification

The scan runs entirely locally — no account, no telemetry. The only network request is an optional check for a newer version on npm (best-effort, skipped in CI, disable with --no-update-check).

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.

Found a bug or want a new check?

Open an issue: https://github.com/Mavoryl/mobile-repo-doctor-action/issues

Bug reports, false positives, and ideas for new checks are all welcome. If you're reporting a bug or a false positive, please include your CLI version (mrd --version) and, if possible, a small example.

Support

Mobile Repo Doctor is built and maintained in my own time. If it saved you a debugging session or caught a store rejection before submission, you can support its development on Patreon. Funding goes straight into new checks, keeping store requirements up to date, and fixing bugs faster. 🙏

License

PolyForm Noncommercial License 1.0.0 — free to use, modify, and share for any noncommercial purpose. Commercial use requires a separate license from the copyright holder (Mavoryl).