Tap through your Flutter app.
Keep it as an automated test.

From a manual walkthrough
to an automated test.

1. 01

   Add the recorder

   SaySpec adds the open-source sayspec_flutter_recorder package to your project and shows every change before it writes a file. The recorder stays off unless SaySpec launches the app, so your normal builds run as before.

2. 02

   Launch it on a device

   Pick an Android emulator, an Android phone or an iOS simulator and launch the app for recording. Start and stop each test from the SaySpec overlay in the app. After Stop, the app restarts for the next test without rebuilding.

3. 03

   Show it and say it

   Tap, drag and type while you narrate what should happen. The recorder captures each action, the screen it happened on and the widget it touched, identified by its key, semantics label or visible text. Your narration is transcribed on your Mac.

4. 04

   Get an automated test

   Your own coding agent, Claude Code or Codex, writes the test with Patrol in a terminal inside SaySpec. SaySpec runs that exact test on your device and saves it only if it passes.

5. 05

   Run it and fix what fails

   Run saved tests on any of your devices. When one fails, SaySpec says whether it looks like an app bug, a test bug, an environment problem or a flaky run, and can propose a fix to your app or to the test. Nothing changes until you approve the exact patch.

Readable Dart.
In your project.

Each test is a Dart file in your project’s patrol_test folder, written with Patrol and Flutter’s own finders. Give important controls a widget key or a semantics label, and the tests keep finding them when the layout changes.

import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:patrol/patrol.dart';

import 'package:shop/main.dart' as app;

void main() {
  patrolTest('coupon reduces cart total', ($) async {
    app.main();
    await $.pumpAndSettle();

    await $(find.byKey(const ValueKey<String>('coupon_field'))).enterText('SAVE20');
    await $('Apply coupon').tap();
    await $.pumpAndSettle();

    expect($('Total: \$60.00'), findsOneWidget);
  });
}

Built for Flutter.
Tested from inside the app.

Patrol is an open-source testing framework built on Flutter’s own integration_test. It finds widgets by key, text and semantics from inside the app, and it can also work with native parts of the phone, such as permission dialogs. Tools that drive the app from outside, such as Maestro or Appium, see only what Flutter exposes to accessibility services.

Read more in Automating Flutter tests: why mobile is harder than web. Testing a web app as well? See web app testing.