Dart + Flutter

VibeCode QA natively supports Dart and Flutter projects — same 34 checks, adapted to the Dart ecosystem.

Quick Start

npx @vibecodeqa/cli

Set up CI + auto-fix

npx @vibecodeqa/cli init    # creates .github/workflows/vibecodeqa.yml
npx @vibecodeqa/cli fix     # auto-fix lint issues + show fix suggestions

Auto-detects: pubspec.yaml, analysis_options.yaml, Flutter vs pure Dart, test runner, melos workspaces.

How Detection Works

When pubspec.yaml exists, VibeCode QA switches to Dart mode:

Signal	Detection
`pubspec.yaml` contains `flutter:`	Flutter project
`flutter_test:` in dev_dependencies	Test runner: flutter_test
`test:` in dev_dependencies	Test runner: dart_test
`analysis_options.yaml` exists	Linter: dart_analyze
`melos.yaml` exists	Monorepo: melos workspace
`pubspec.lock`	Package manager: pub

Dart-Adapted Checks

Foundations

Check	Dart Adaptation	Tool
Structure	Checks `pubspec.yaml`, `analysis_options.yaml`, LICENSE, .gitignore. Source in `lib/` (not `src/`)	built-in
Lint	Runs `dart analyze --format=machine`	dart analyze
Type Safety	Counts `dynamic` type usage, `as dynamic` casts, `// ignore:` directives, `late` without `final`	built-in

Testing

Check	Dart Adaptation	Tool
Test Discovery	Finds `*_test.dart` files in `test/` directory	built-in
Test Execution	Runs `flutter test` or `dart test`	flutter_test
Pyramid	Classifies tests into unit/widget/integration/golden layers	built-in

Dependencies

Check	Dart Adaptation	Tool
Outdated	Runs `dart pub outdated --json`	dart pub
Major Outdated	Flags packages behind by a major version	built-in

Unchanged (work the same as TS/JS)

Complexity, duplication, error handling, secrets, security patterns, architecture, confusion, context, docs, best practices, performance — all work on Dart code files.

Melos Monorepo Support

Detected via melos.yaml. When found:

Parses packages: section for workspace globs
Scans packages/*/lib/ for source and packages/*/test/ for tests
Architecture diagrams show cross-package dependencies
All scoring proportional to total codebase size

# melos.yaml
name: my_project
packages:
  - packages/*
  - apps/*

Recommended Tool Setup

# Core (included with Flutter SDK)
dart analyze                       # lint
dart test / flutter test           # tests
dart pub outdated                  # dependency freshness

# Security
brew install gitleaks              # secret detection

# Code quality (no extra install needed)
# VibeCode QA handles complexity, duplication, architecture

Dart-Specific Patterns We Check

Type Safety

Pattern	Severity	Why
`dynamic` type annotation	Warning	Bypasses static analysis — use `Object` or proper types
`as dynamic` cast	Warning	Unsafe cast — will crash at runtime if wrong type
`// ignore:` directive	Error	Disables analyzer for a line — hiding real issues
`// ignore_for_file:`	Error	Disables analyzer for entire file — very dangerous
`late` without `final`	Info	Mutable late vars can throw if accessed before init

What We Don't Cover (Yet)

Widget test golden comparisons (screenshot diff testing)
Flutter-specific lint rules (prefer_const_constructors etc.) — covered by flutter_lints
Dart-specific security patterns (HTTP without TLS) — covered by dart analyze
pub.dev score integration (planned)

Home · Tool Decisions · TypeScript + React · Node.js Guide