Flutter Quality Assist

Flutter Quality Assist is a lightweight Dart CLI tool designed to analyze Flutter projects and detect common code quality, architecture, performance, and maintainability issues.

This tool helps Flutter developers identify bad coding practices early and encourages cleaner, scalable, and production-ready Flutter codebases.

Features

Flutter Quality Assist can detect:

✅ print() statements in production code
✅ Large widget files
✅ Large build() methods
✅ Hardcoded colors
✅ Hardcoded UI strings
✅ Missing const constructors
✅ Excessive setState() usage
✅ BuildContext usage after async gaps
✅ Missing mounted checks
✅ Missing dispose() methods
✅ Deep widget nesting
✅ Business logic inside UI widgets
✅ Repeated button styles
✅ Repeated text styles
✅ Large StatefulWidgets
✅ Missing Keys in ListView.builder
✅ Repeated MediaQuery usage
✅ Excessive Theme.of(context) usage
✅ Repeated spacing/padding values
✅ Long parameter lists
✅ Large methods/functions
✅ Navigation code repetition
✅ Repeated SizedBox spacing
✅ and many more Flutter quality checks...

Why Use This Package?

Flutter projects often become difficult to maintain when:

Widgets grow too large
Business logic mixes with UI
Hardcoded styles are repeated
State management becomes messy
Reusable components are not created
Flutter best practices are ignored

Flutter Quality Assist helps identify these issues automatically and provides suggestions to improve the codebase.

Installation

Add Flutter Quality Assist to your project:

dev_dependencies:
  flutter_quality_assist: ^1.0.0

Install dependencies:

flutter pub get

Usage

Run the analyzer inside your Flutter project:

dart run flutter_quality_assist analyze

Example Output

🚀 Analyzing Flutter project...

❌ Hardcoded colors detected
📄 File: lib/screens/home_screen.dart
✅ Recommendation: Move colors to AppColors/theme constants.

❌ Large build() method detected
📄 File: lib/screens/dashboard_screen.dart
✅ Recommendation: Break UI into smaller widget methods/components.

❌ print() found in production code
📄 File: lib/services/api_service.dart
✅ Recommendation: Use logger package instead.

❌ BuildContext used after async gap
📄 File: lib/screens/login_screen.dart
✅ Recommendation: Check mounted before using context.

✅ Analysis completed.