Skip to content

About

See what ships inside a Flutter app. Offline, on-device audits for Flutter APKs: libraries, endpoints, exposed strings and package policy, with confirmed facts kept apart from leads. Release-to-release diffs, Dart snapshot evidence, and a JSON/SARIF CLI for CI. No root, no account, no uploads.

Topics

Resources

Stars

34 stars

Watchers

0 watching

Forks

Repository files navigation

FlutterGuard app icon

FlutterGuard

See what ships inside a Flutter app.

Open an installed Flutter app, or a single APK, and read its libraries, endpoints and exposed strings. The whole audit runs on your phone: no uploads, no account, no setup.

Every result is sorted into confirmed artifact facts, leads worth checking and plain inventory, so a string match never reads as an exploit. Scan the same app twice and it tells you what actually changed between the two releases.

Release License: MIT Platform Offline

Get it on Google Play · Download the APK · Website · Guides · Checklist · Corpus · Changelog · Privacy

FlutterGuard — inspect a Flutter app and keep the evidence, offline, on your phone

Worth knowing first

A permissions screen only tells you what an app asks for. A Flutter release keeps most of its real surface somewhere else: the compiled library, the asset bundle, the manifests and policy files inside the package.

FlutterGuard reads those layers and puts them into one readable report, so you can decide for yourself what deserves a closer look.

It is free, open source, and it never sends your data anywhere.

Screenshots

App inventory Report grade Findings
Installed Flutter app inventory Evidence-backed app grade and report summary Findings list: exported service, cleartext traffic and user CA trust
Endpoints and routes Settings Privacy
Candidate endpoints and route prefixes recovered from strings Settings: notifications, scan history, scan-all and re-scan controls Readable in-app privacy policy

What a scan shows you

  • Libraries — the building blocks it can identify, with version evidence when the release keeps it.
  • Connections — endpoints, domains and AI-provider markers left in the package.
  • Exposed strings — secret-pattern matches, with values masked until you choose to reveal them.
  • Package policy — permissions, signing information and network-security configuration.
  • App structure — Flutter assets and candidate route strings, kept as clues rather than pretend navigation.
  • Confidence — each finding is an accepted fact from the package (a decoded policy, a real manifest attribute), a lead that needs a human eye, or informational inventory.
  • Dart snapshot evidence — the compiled library's snapshot header, kind, build features and serialization hash, read directly from the artifact when the format is recognised.
  • Release changes — compare two scans to see new permissions, hosts, SDKs, native libraries, signing certificates, network policy and findings, plus what disappeared.
  • Reports — saved on the phone, ready to revisit, and exportable as JSON or Markdown when you ask for it.

How it works

  1. Discover — pick an installed Flutter app, or open a single APK file.
  2. Inspect — follow each finding back to the file, string or policy that produced it.
  3. Report — keep the evidence on your phone and come back to it later.

Scans run one at a time and show real progress, so you can leave the screen without losing the run.

Install

  • GitHub — download FlutterGuard-<version>.apk from the latest release, then allow installs from your browser or file manager when Android asks.
  • Google Play — store listing. Availability depends on Google's review and rollout in your region. If the listing is not open yet, use the GitHub APK.

Android 8.0 or newer. No Play Services needed.

Upgrading from an older GitHub APK? Recent builds use a new signing key, so Android will not install over the old one. Export anything you want to keep, uninstall, then install the new APK. Uninstalling removes stored reports and settings, and an export does not restore the in-app history.

What the grade means

A is clean, C is a well-built app with a few hardening gaps, F failed on something fundamental. Only confirmed artifact facts feed the grade, so an unproven lead can never sink an app on its own. It is a triage label, not a score: read the findings, not the letter.

Comparing two releases

Scan a version, install the next one, scan again. The report shows what arrived and what left: permissions, endpoints, SDK and dependency markers, native libraries, signing certificates, the network-security policy, and the findings themselves.

Comparisons are built from the saved reports, never from a guess. If a category could not be read in one of the two scans, it says so instead of claiming nothing changed, and a scan of a different package is refused rather than diffed against an unrelated app. Finding identities carry the rule and a masked source, never the matched value, so an exported comparison stays safe to share.

From a terminal or CI

The detection engine is a plain JVM library, and the CLI runs it without Android:

flutterguard scan app-release.apk --json report.json --sarif report.sarif --fail-on confirmed
  • exit 0 when nothing confirmed crossed the gate, 1 when something did, 2 for any argument, input, scan or output error
  • the JSON report matches the schema the app writes, so the same file works everywhere
  • SARIF points at the APK, one rule per finding id, with no invented source lines
  • outputs are published atomically and progress goes to stderr without recovering values

The workflow in .github/workflows/apk-scan.yml runs the tests, scans a build, and uploads the report; docs/cli.md has the full contract.

Honest limits

A tool that overstates itself is worse than none, so:

  • It reads the package. Nothing is hooked, intercepted or executed.
  • Findings are static evidence, not proof that something is exploitable.
  • A snapshot header describes how the Dart library was built. It carries no obfuscation flag, no app identity and no version, so when the format is not recognised the field stays unknown.
  • "Few names recovered" is a heuristic about a string table, not a verdict that code is obfuscated.
  • It reads APKs. Convert an AAB with bundletool first.
  • Some phones block reading other apps' files. That is the OS deciding, not a setting in the app.
  • Only scan apps you own or are allowed to test.

Built for developers

git clone https://github.com/anasfik/flutterguard.git
cd flutterguard
echo "sdk.dir=$ANDROID_HOME" > local.properties
./gradlew assembleRelease          # signed APK in app/build/outputs/apk/release/
./gradlew :cli:installDist         # CLI launcher in cli/build/install/flutterguard/bin/

Release builds read FG_KEYSTORE, FG_KEYSTORE_PASSWORD, FG_KEY_ALIAS and FG_KEY_PASSWORD, falling back to .keystore/flutterguard.jks. Debug builds use the debug key.

Three Gradle modules share one detection engine: app (Compose UI and platform access), engine (pure JVM scanners, rules and report models) and cli (the CI entry point). benchmark-app/ is a synthetic Flutter app with planted findings, and benchmarks/ scores the CLI against it — the harness only counts assertions it was told to judge, so its numbers stay honest.

skill/SKILL.md turns the app into an audit workflow for coding agents, and CORPUS.md records the real app that produced each detector. Kotlin and Jetpack Compose, Material 3, one colour scheme for light and dark.

Privacy

Reports stay in the app's private storage. The app has no INTERNET permission, so there is no analytics, no crash reporting and nothing to phone home. A report leaves the device only when you export it and pick a destination, and sensitive values stay masked unless you deliberately reveal them. Treat an export that contains them as sensitive.

Contact

Built by Anas Fikhi. Questions, a suspicious finding, or an idea for the next release: work@gwhyyy.com or open an issue.

Only scan apps you own or have written permission to test.

MIT licensed · offline by design

About

See what ships inside a Flutter app. Offline, on-device audits for Flutter APKs: libraries, endpoints, exposed strings and package policy, with confirmed facts kept apart from leads. Release-to-release diffs, Dart snapshot evidence, and a JSON/SARIF CLI for CI. No root, no account, no uploads.

Topics

Resources

Stars

34 stars

Watchers

0 watching

Forks

Releases

Contributors

Languages