# Poorgramer Zack Flutter Agent Panel Flutter Testing

> Flutter Testing Guide

- Skill: `tomevault-io/poorgramer-zack-flutter-agent-panel-flutter-testing` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/poorgramer-zack-flutter-agent-panel-flutter-testing`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/poorgramer-zack-flutter-agent-panel-flutter-testing/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/poorgramer-zack-flutter-agent-panel-flutter-testing

---

# Flutter Testing Guide

## Overview
Flutter testing follows a three-layer pyramid: **Unit** (fast, pure Dart logic) → **Widget** (UI component rendering) → **Integration/E2E** (full device flows). Each layer has distinct tooling and tradeoffs. Load the relevant reference based on what you need to test.

## Process

### Phase 1: Choose the Right Layer
Identify the testing tier before writing any code. Wrong tier = wasted effort.
- [🧱 Testing Fundamentals](./references/testing-fundamentals.md) — Decision tree for choosing unit/widget/integration, MVVM isolation patterns, and project structure.

### Phase 2: Write Tests with Correct APIs
Apply AAA (Arrange-Act-Assert), proper pump usage, and matcher selection.
- [🛠️ Core Testing](./references/core-testing.md) — Unit test groups/setUp/tearDown, widget test pump patterns, integration test binding setup, and async troubleshooting (FakeAsync, runAsync, Timer leaks).

### Phase 3: Mocking, Goldens, and E2E
Isolate external dependencies, lock UI visuals, and validate native OS interactions.
- [🧪 Advanced Tools](./references/advanced-tools.md) — Mocktail/Mockito, golden tests with cross-platform tolerance, Patrol 4.0 E2E (native permission dialogs, notifications), patrol_finders for widget tests.

### Phase 4: Diagnose Failures
Resolve production testing failures in CI/CD pipelines.
- [🔧 Troubleshooting](./references/troubleshooting.md) — Async errors, golden pixel diffs, MediaQuery crashes, Timer memory leaks, flaky mock configurations.

---

## 📚 Reference Library

- [🧱 Testing Fundamentals](./references/testing-fundamentals.md)
- [🛠️ Core Testing](./references/core-testing.md)
- [🧪 Advanced Tools (Mocking, Goldens, Patrol E2E)](./references/advanced-tools.md)
- [🔧 Troubleshooting & Edge Cases](./references/troubleshooting.md)

---
> Source: [Poorgramer-Zack/flutter-agent-panel](https://github.com/Poorgramer-Zack/flutter-agent-panel) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-16 -->