Flutter Add Widget Test

Use this when you want a component-level test for a single Flutter widget, checking that it renders the right data and responds to taps, text entry, or scrolling without spinning up a full integration run. It walks through the standard `testWidgets` flow: pump the widget, locate elements with `Finder`s, assert with `Matcher`s, simulate interactions, then call `pump` or `pumpAndSettle` depending on whether you're waiting on a single rebuild or an animation. The example is a todo list with add and swipe-to-dismiss, which covers the `enterText`, `tap`, and `drag` paths well. One honest caveat: the sample wraps the widget in a `MaterialApp` inside `build`, which is a pattern worth questioning in your own code since it nests navigation and theming in the widget under test. The checklist and conditional guidance on when to use `pump` versus `pumpAndSettle` are the most reusable parts.

skills.sh installs: 41.4K
GitHub stars: 3.2K
last updated: Oct 26, 2026

View on GitHub

Install

$ npx -y skills add flutter/agent-plugins --skill flutter-add-widget-test --agent claude-code

Installs into .claude/skills of the current project.

Files

Setup & Configuration

Ensure the testing environment is properly configured before authoring widget tests.

Add the flutter_test dependency to the dev_dependencies section of pubspec.yaml.
Place all test files in the test/ directory at the root of the project.
Suffix all test file names with _test.dart (e.g., widget_test.dart).