Profile Flutter Startup and Frame Performance
Measure Flutter mobile startup and rendering on physical devices in profile mode, distinguish UI and raster work, and verify fixes against comparable traces.
Choose one startup milestone and one repeatable slow gesture before tracing. First frame, first useful content and first successful interaction are separate measurements. A login bootstrap can reach first frame rapidly and still block the first meaningful action. Record the intended metric and mark the code paths that define it without collecting user identifiers. ## Key Points - [Flutter build modes](https://docs.flutter.dev/testing/build-modes) - [Flutter DevTools Performance view](https://docs.flutter.dev/tools/devtools/performance) - [Flutter code instrumentation and tracing](https://docs.flutter.dev/testing/code-debugging) - [Flutter web performance](https://docs.flutter.dev/perf/web-performance)
skilldb get flutter-skills/flutter-startup-and-frame-profilingFull skill: 30 linesProfile Flutter Startup and Frame Performance
Choose one startup milestone and one repeatable slow gesture before tracing. First frame, first useful content and first successful interaction are separate measurements. A login bootstrap can reach first frame rapidly and still block the first meaningful action. Record the intended metric and mark the code paths that define it without collecting user identifiers.
Collect a comparable baseline
Use profile mode on a representative physical device for mobile measurements. Record Flutter and engine versions, renderer, OS, refresh rate, build revision, device thermal state, and data fixture. Treat a cold process start, warm resume and first launch after install as separate scenarios. State whether assets and network responses are cached and reset only the state relevant to the comparison. Keep debug screenshots and emulator timing out of the release-performance baseline.
Use the DevTools Performance view for Flutter frame and timeline data. Capture an application marker around expensive startup stages such as synchronous bootstrap work, essential hydration and the first usable UI. Use trace markers that can be tied to a real observable screen or action. Repeat each launch or gesture and preserve the median and slow tail with the raw samples. Use the actual display refresh budget; a 60 Hz budget does not apply to every display.
Trace cause before changing the implementation
Separate UI work from raster work. If the UI portion is expensive, inspect the relevant frame and widget build, layout, or paint events. Enable extra tracing only for diagnosis because instrumentation has a cost. Count rebuilds in the affected subtree and check whether changing state at a narrower ownership boundary avoids unnecessary work. A rebuild count alone does not establish frame cost. If the raster portion dominates, investigate the specific layer, shader, image size or effect shown by the trace. A delayed asynchronous request may explain slow useful content without producing a long frame.
Prefer one targeted change per comparison. Re-run baseline and candidate on the same device with the same workload and observable result. Test both cold and warm starts where relevant. Check that moved work remains correct and does not reappear as jank during the next interaction. Retain traces, percentile or individual frame results, test limitations, and the user-visible milestone you improved. If web is in scope, use the web-specific Flutter and browser tools rather than assuming the mobile DevTools flow applies.
References and rights
- Flutter build modes
- Flutter DevTools Performance view
- Flutter code instrumentation and tracing
- Flutter web performance
Original SkillDB instructions under LicenseRef-SkillDB-Content. References were checked 2026-11-13 and used for technical verification.
Install this skill directly: skilldb add flutter-skills
Related Skills
Local Storage
Hive, SharedPreferences, and Drift patterns for local data persistence in Flutter
Manage Flutter and Dart Monorepos with Melos
Set up Dart Pub workspaces and Melos for local package resolution, scoped scripts, and predictable verification across dependent Flutter packages.
Navigation
GoRouter navigation patterns for declarative, deep-linkable Flutter routing
Networking
Dio HTTP client and API integration patterns for Flutter applications
Platform Channels
Platform channels for bridging Flutter with native Android (Kotlin) and iOS (Swift) code
State Management
Riverpod and Bloc state management patterns for scalable Flutter applications