Managing Dart Language Versions

Contents

• Core Guidelines
• Configuration & Overrides
• Workflows
• Examples
• Breaking Changes Reference
• Related Skills

Core Guidelines

• Check current language version requirements in pubspec.yaml before initiating any migration or refactoring.
• Consult breaking change logs before performing major dependency or SDK upgrades.
• Use @dart = <version> to pin specific files to older versions during gradual migrations (e.g., migrating a large project to a new language feature like sound null safety).
• Understand Version Derivation: The default language version for a package is strictly determined by the lower bound of the SDK constraint in pubspec.yaml. Patch versions do not introduce new language features.

Configuration & Overrides