# bamlab/flashlight

📱⚡️ Lighthouse for Mobile - audits your app and gives a performance score to your Android apps (native, React Native, Flutter..). Measure performance on CLI, E2E tests, CI...

Repository: https://github.com/bamlab/flashlight
Canonical: https://ross.abutalabs.com/products/bamlab-flashlight
Homepage: https://docs.flashlight.dev
Language: TypeScript
License: MIT
License Family: permissive
Topics: android, performance, react-native, flutter, lighthouse, native, e2e, mobile, apm, monitoring, profiling, tracing, audit, performance-optimization, performance-testing
Last push: 2026-08-26T18:48:50+00:00

## Health v2 (maintenance only)
Score: 67/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 8, longevity 100
- inputs: {"age_days": 1596, "days_push": 7, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1602, forks 48 (observed 2026-08-28T04:05:09.682699+00:00)

## What it is
Flashlight is a CLI tool that audits Android apps (native, React Native, Flutter) and generates a performance score from aggregated metrics, similar to Lighthouse but for mobile. It supports manual measurement, automated E2E performance testing, and cloud device runs for CI integration.

## Use cases
- measure performance score of my android app
- benchmark react native app performance
- run automated performance tests in CI
- compare flatlist vs flashlist performance
- profile fps and cpu usage on android device
- audit production app performance without setup
- run e2e performance tests over multiple iterations

## When to choose
- you need a Lighthouse-style performance score for Android apps
- you want to automate performance regression testing in CI or E2E suites
- you need to measure production apps with no in-app instrumentation
- you work with React Native or Flutter and want comparable perf metrics

## When to avoid
- you need iOS performance auditing (support is still in progress)
- you need full APM with production crash and network monitoring
- your target platform is web rather than mobile

## Facets
- artifact type: cli-tool
- maturity: active
- function: monitoring, benchmarking, tracing, testing, e2e-testing
- domain: mobile-development, performance, developer-tools, testing
- platform: cli, cross-platform
- tags: performance-score, apm, profiling, react-native, flutter, lighthouse-for-mobile, ci-integration, android

## Member repositories
- bamlab/flashlight (main) score 67

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:09.682699+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T03:52:36.924804+00:00, confidence not recorded.
  - readme: https://github.com/bamlab/flashlight (fetched 2026-08-28T04:05:09.682699+00:00, sha 7b946faccede)
  - homepage: https://docs.flashlight.dev (fetched 2026-08-29T11:24:32.027303+00:00, sha b028c89d0026)
- Data as of 2026-08-30T08:39:29.467469+00:00.