Update Flutter Dependencies
Use this skill for SDK and package upgrades that must stay stable and reviewable.
Workflow
- •Capture baseline:
- •
flutter --version - •
flutter doctor -v - •
flutter pub get - •baseline checks (
flutter analyze+ impacted tests)
- •
- •If Flutter SDK upgrade is in scope, upgrade Flutter SDK:
- •
flutter upgrade - •record updated
flutter --version - •otherwise, keep the current SDK pinned and continue with package updates only
- •
- •Inspect package surface:
- •
flutter pub outdated - •identify major updates and likely breaking packages
- •
- •Upgrade in small batches:
- •prefer targeted updates before full upgrade
- •after each batch:
flutter pub get,flutter analyze, impacted tests
- •Fix breaking changes:
- •address compile and analyzer issues first
- •update tests to reflect intended behavior changes
- •Finalize:
- •summarize version deltas
- •list breaking changes handled
- •provide rollback plan
Guardrails
- •Do not mix unrelated refactors.
- •Keep every step in a buildable state where possible.
- •If failures cascade, split into two PRs:
- •Flutter SDK upgrade
- •package upgrade and fixes
- •Always include before/after version snapshot and explicit rollback trigger.
Required output
- •Before/after Flutter version.
- •Key dependency changes.
- •Validation commands run and their result.
- •Files changed for compatibility fixes.
- •Rollback instructions.
- •Known remaining risks after upgrade.