Skip to content

GitHub Action

Run the scanner in CI and fail the job on serious findings.

name: Repo Health
on: [push, pull_request]

jobs:
  health:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: Mavoryl/mobile-repo-doctor-action@v1
        with:
          fail-on: 'high'        # none | critical | high | score-below-N
          output: 'html,json'

The scan runs on the runner — no API key, no account, your code never leaves CI.

Inputs

Input Default Description
fail-on none Failure policy: none, critical, high, or score-below-N (e.g. score-below-70)
output html,json Report formats (comma-separated): html, json, md
scan-path repo root Path to scan
verbose false Verbose output
upload-artifacts true Upload the reports as workflow artifacts
artifact-name repo-doctor-report Artifact name

Outputs

score, grade, findings-count, critical-count, high-count, exit-code — use them in later steps, e.g.:

      - run: echo "Score ${{ steps.scan.outputs.score }} (${{ steps.scan.outputs.grade }})"