Flutter Tester

This is a comprehensive testing guide for Flutter projects that covers the full stack: unit tests, widget tests, integration tests, and Riverpod provider testing. It pushes a clear architecture where you test each layer in isolation using Given-When-Then structure, mock dependencies but never providers (override them instead), and always reset GetIt in tearDown. The reference tables are genuinely useful, especially the quick lookup for what to mock at each layer and common mistakes like forgetting to set screen size in widget tests or using Future.delayed instead of pumpAndSettle. If your Flutter codebase uses Riverpod and GetIt, this will save you from rewriting the same test setup patterns.

skills.sh installs: 439
GitHub stars: 68
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add harishwarrior/flutter-claude-skills --skill flutter-tester --agent claude-code

Installs into .claude/skills of the current project.

Files

Flutter Tester

Requirements

Flutter project with flutter_test dependency
Works with Riverpod, Mockito, and GetIt
Run dart run build_runner build to generate mocks after adding @GenerateMocks annotations
Compatible with FVM (fvm flutter test instead of flutter test)

Overview

Test each architectural layer in isolation using Given-When-Then structure. Always test both success and error paths. Never mock providers — override their dependencies instead.

Reference Files

Load the relevant file based on what you're testing:

What you're testing	Reference file
Repository, DAO, Service logic	`references/layer_testing_patterns.md`
Widget UI, interactions, dialogs, navigation	`references/widget_testing_guide.md`
Riverpod provider state, mutations, lifecycle	`references/riverpod_testing_guide.md`