# Flutter Upgrade

> Flutter SDK upgrade workflow with channel/version discovery, migration awareness, and format/analyze/test verification gates.

- Skill: `nickcuypers/flutter-upgrade` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add nickcuypers/flutter-upgrade`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nickcuypers/flutter-upgrade/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: nickcuypers (https://skillmd.com/u/nickcuypers)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/nickcuypers/flutter-upgrade

---


## When to use / when NOT to use
- Use for Flutter SDK upgrades and migration checks.
- Do not use for dependency-only updates (use `flutter-deps-upgrade`).

## Preconditions (tools, versions, repo state)
- Flutter/Dart installed and on PATH.
- Flutter workspace (`pubspec.yaml`) available.
- Clean git state before execute.

## Workflow (DISCOVER → PLAN → EXECUTE → VERIFY → REPORT)
1. DISCOVER: inspect Flutter version/channel, monorepo tooling, analyzer config.
2. PLAN: identify upgrade scope and potential breaking-change hotspots.
3. EXECUTE: run `flutter upgrade` and `flutter pub get`.
4. VERIFY: run `dart format` check, `flutter analyze`, `flutter test`.
5. REPORT: summarize outcomes and required manual migrations.

## Exact commands and expected signals
```bash
skills/flutter-upgrade/scripts/run.sh --dry-run
skills/flutter-upgrade/scripts/run.sh --execute --ci
skills/flutter-upgrade/scripts/run.sh --verify-only --ci
```
Success: verification pipeline runs and report generated.
Failure: missing Flutter toolchain/project or analyzer/test errors.

## If it fails (checklist)
- Run `flutter doctor` and resolve toolchain issues.
- Ensure SDK constraints in `pubspec.yaml` fit target channel.
- Re-run with `--verbose` and inspect first failing stage.

## Final report template
- Current vs upgraded Flutter version/channel.
- Files affected and dependency lock changes.
- Analyze/test/build outcomes.
- Breaking-change follow-ups.
- Rollback command.