Get a performance score for your app 🔦

Flashlight generates a performance score for your Android app, aggregating different metrics. (📱 iOS support is also in the works)

🙅 No setup required in your app
🚀 Measure performance even on production apps
✨ Generates beautiful reports (like this Flatlist/Flashlist comparison)

With Flashlight 🔦, you can either:

• Upload an app and get your performance score on app.flashlight.dev

Or use the CLI:

• flashlight measure: quickly audit your perf with real-time measures
• flashlight test: automate your measures with e2e performance testing over several iterations
• flashlight cloud: run measures on real devices in the cloud & integrate in your CI setup

Installation

macOS/Linux

curl https://get.flashlight.dev | bash

Windows

iwr https://get.flashlight.dev/windows -useb | iex

Usage

Head over to the docs at docs.flashlight.dev

Contributing

We love pull requests! Head over to the contribution guide to get started.

Change Log

All notable changes to this project will be documented in this file. See Conventional Commits for commit guidelines.

0.13.0 (2024-07-17)

Features

• customize binary path (#300) (ee9e168)

0.12.1 (2024-06-28)

Bug Fixes

• don't crash profiler if we can not parse FrameTime (#295) (8aee5ec)
• profiler: fix ram usage when multiple pids (#290) (85656a7)

0.12.0 (2024-06-04)

Bug Fixes

• profiler: improve performance (#280) (512a994)
• profiler: support rare apps with multiple pids (#274) (60ea349)

Features

• report: make RN and Flutter threads stand out nicely (#205) (0e99a27)

0.11.0 (2024-03-01)

Bug Fixes

• fix graph curviness bugs by upgrading apex (#204) (0223202)
• getCpuStatsByProcess: fix regex for CPU stats (#181) (b4d5de6)
• measure: support empty thread name (52dce42)

Features

• ios: add time Profiler (#188) (b04984d)

0.10.7 (2023-09-14)

Note: Version bump only for package @perf-profiler/profiler

0.10.6 (2023-08-18)

Bug Fixes

• fix tests that could timeout after an app crash (#146) (cbbe38e)

0.10.5 (2023-07-31)

Note: Version bump only for package @perf-profiler/profiler

0.10.4 (2023-07-31)

Note: Version bump only for package @perf-profiler/profiler

0.10.3 (2023-07-31)

Bug Fixes

• profiler: improve accuracy of CPU measures (#140) (5038cb7)

0.10.2 (2023-07-12)

Bug Fixes

• profiler: add sigint to authorized exit codes (3447a38)

0.10.1 (2023-07-12)

Bug Fixes

• profiler: no such file /proc/{pid}/task (#117) (a3db43f)

0.10.0 (2023-06-28)

Features

• measure: measure in webapp without need for flipper (#121) (6f68b55)

0.9.2 (2023-05-25)

Bug Fixes

• profiler: fix some cpu measuring inaccuracies (#109) (79b6f79), closes 392744175c4de67dc98e72da6745e6351118c985/toolbox/top.c#422

0.9.1 (2023-05-19)

Bug Fixes

• profiler: fix buffer overflow when running atrace async_stop (#107) (f06a849)

0.9.0 (2023-05-08)

Bug Fixes

• profiler: fallback on alternative atrace file for certain devices (#100) (93ad2c8)

Features

• flipper: integrate new design (#104) (b3410b5)

0.8.0 (2023-04-26)

Features

• test: add record bitRate and size option (#97) (364f58a)

0.7.0 (2023-04-19)

Features

• profiler: group binder threads together in measures (#89) (543ffa7)

0.6.0 (2023-04-18)

Bug Fixes

• profiler: improve timings accuracy (#84) (1908689)

Features

• add --record options to have videos in report (#86) (2094d38)
• add windows support (#77) (b6d152c)

BREAKING CHANGES

• profiler: if using a custom script, pollPerformanceMeasures will now take { onMeasure: (Measure) => void } as second parameter

0.5.0 (2023-02-06)

• feat!: prepare for standalone executable (#71) (3d6aa79), closes #71

BREAKING CHANGES

• commands have additional prefix, see readme for changes

• chore: ensure standalone executable work with c++ binaries

• chore(web): put report in tmp dir by default

This is especially important for the standalone executable

• docs: revamp docs with docusaurus

0.4.2 (2022-12-16)

Bug Fixes

• profiler: make FPS polling safer (#62) (2c5edd8)

0.4.1 (2022-11-03)

Bug Fixes

• profiler: ensure fps > 0 (13c8c7b)

0.4.0 (2022-10-28)

Features

• cppProfiler: throw an error if SDK version is less than 24 (Android 7) (#40) (ba5a880)
• profiler: prepare for flipper plugin publish (#42) (43e97e3)

0.3.2 (2022-10-13)

Note: Version bump only for package @perf-profiler/profiler

0.3.1 (2022-09-27)

Bug Fixes

• profiler: fix bundle id option in profile command (595060d)

0.3.0 (2022-09-27)

Features

• profiler: improve fps accuracy by using atrace for reporting (#28) (ad161d5)

0.2.0 (2022-09-07)

Bug Fixes

• profiler: detect appActivity when command output doesn't contain "$" (6332d7b)

Features

• profiler: replace bundle id by "UI Thread" in CPU measures (0653a46)

0.1.0 (2022-08-30)

0.1.0-alpha.9 (2022-08-29)

0.1.0-alpha.8 (2022-08-27)

Features

• profiler: add c++ version (4c56697)
• profiler: add command to print app activity (1d81cde)
• profiler: add spawn function (e6eba2e)
• profiler: add ts file to interface with c++ profiler (57c7bb2)
• profiler: add useful commands (a7c5dba)
• profiler: always ensure c++ profiler is installed (1982760)
• profiler: replace with cpp profiling (1e85b84)

0.1.0-alpha.7 (2022-08-12)

0.1.0-alpha.6 (2022-08-12)

0.1.0-alpha.5 (2022-08-12)

0.1.0-alpha.4 (2022-08-08)

Features

• fps: auto enable debug.hwui.profile (12a4042)

0.1.0-alpha.3 (2022-08-04)

Bug Fixes

• fps: take idle frames into account (125e2e2)

Features

• add FPS poc (6fe3398)
• add ram usage (1f1515a)
• add some gfxinfo parsing (f365604)
• build better comparison view (6228ab4)
• improve execLoopCommands (3d0c78a)
• introducing flipper-plugin-android-performance-profiler (dc18a3c)
• measure fps (b643918)

Performance Improvements

• improve reporting time accuracy (fb0ea48)