Skip to content

Mobile Repo Doctor

A health scanner for Android, iOS, Flutter, and Kotlin Multiplatform repositories. Point it at a project and get a scored report — findings, why they matter, and how to fix them — in a few seconds.

  • 115 checks across size, speed, stability, and hygiene
  • Runs fully offline — no account, no upload, your code never leaves your machine
  • Free
  • Reports in HTML (dashboard), JSON, and Markdown (built for AI/LLM review)
  • Ships as a CLI and a GitHub Action

Quick start

npm install -g mobile-repo-doctor
mrd scan .

That prints a summary and writes an HTML report. See Getting started for options and Reports for the output formats.

How it works

The scanner walks your repository, detects the stack, and runs the relevant analyzers. Each finding has a stable id, a severity, a short reason, and a concrete fix. Findings roll up into four 0–100 axes — size · speed · stability · hygiene — and an overall A–F score.

Browse every check in the Checks reference.

What it catches (a taste)

  • targetSdk below the level Google Play currently requires → your upload will be rejected
  • Hardcoded secrets (AWS/Stripe/GitHub/… keys) in source — values redacted in the report
  • Broken or out-of-sync ARB localization files (missing keys, placeholder mismatches)
  • Oversized assets, duplicates, and bitmaps hidden inside SVG/Lottie
  • CI that publishes a release without running tests, or builds a debug artifact
  • KMP version drift and expect/actual gaps