pubspec

pubspec_overrides.yaml is a file next to pubspec.yaml that pub reads on top of it, limited to dependency_overrides, resolution and workspace. It replaces the whole dependency_overrides section, applies workspace-wide, and is left out of published archives. What it does, when to use it in a monorepo, and every edge case, verified on Dart 3.12.2.

depend_on_referenced_packages fires when a file imports or exports a package that is not listed in your own pubspec.yaml, even if it resolves through another dependency. Here is exactly what the rule checks on Dart 3.12.2 and Flutter 3.44.8, why transitive imports are a real bug, and how to fix each variant.

The asset key is missing from the compiled bundle, not from your disk. Fix the pubspec indentation, add the trailing slash, match the key exactly, then full restart.

The fix in 30 seconds: read the 'because' chain in the error, find the one constraint that boxes pub in, and either widen it or add a dependency_overrides entry. Do not start with flutter clean.