FrameGuard 0.6.0

Summary

FrameGuard 0.6.0 adds local history and gradual drift tracking, budget suggestions from measured reports, and a reusable GitHub Action so you can gate Flutter UI performance in CI — still local by default, with no telemetry.

Published on pub.dev.

Highlights / What’s new

• Local history store (FrameGuardHistory / JSONL) with CLI history append|show|list|drift|clear
• Budget suggestions — BudgetSuggestion + CLI suggest-budget to draft budgets from measured reports
• CI helpers — check --require-profile, check --record-history, and reusable composite action .github/actions/frameguard-check
• Explanation JSON round-trip — ScenarioExplanation.fromJson plus report decode
• Version sync CI — tool/sync_version.dart --check for package version drift detection
• Init scaffolds a history/ directory

Fixes

• Healthy reports no longer mislabeled as “Excessive build work”
• hasJankRateBelow treats the limit as inclusive (<=)
• .gitignore no longer excludes GitHub Pages HTML under docs/
• pub.dev topics trimmed to the 5-topic limit

Changed

• CLI migrate re-encodes report metadata to the current package version

Breaking changes: none.

Install from pub.dev

dependencies:
  frameguard: ^0.6.0

dart pub add frameguard

Package: https://pub.dev/packages/frameguard

Links

• Docs site: https://theworker02.github.io/frameguard/
• CLI guide: https://theworker02.github.io/frameguard/cli.html
• Getting started: https://theworker02.github.io/frameguard/guide.html
• Repository: https://github.com/theworker02/frameguard
• Changelog: https://github.com/theworker02/frameguard/blob/main/CHANGELOG.md
• Sponsor: https://thanks.dev/u/gh/theworker02 · https://github.com/sponsors/theworker02