Dartmole
The Dartmole app icon

See what your Flutter app says to the network.

Dartmole is a Mac app that shows every HTTP call your Flutter app makes on a phone or simulator, and answers them with mocks from your repo. Pair by scanning a QR code: no system proxy, and no certificate to install on the device.

Download for Mac

Version 0.1.0 · macOS 12 or later · Apple silicon

Pairs with a QR code

Add dartmole_plugin, scan the code Dartmole shows, and the app’s Dart HTTP calls go through Dartmole. Only that app: the rest of the device is left alone.

TLS stays on

The plugin trusts Dartmole’s certificate for its own client, from the moment you pair. It never switches certificate checks off, and nothing is compiled into your app.

Every call, readable

Method, status, timing, headers and query parameters at a glance, and JSON bodies as a tree you can fold and search.

Mocks live in your repo

Answer a call with a canned response or an error. Mocks are plain files in .dartmole/mocks, so they are reviewed in pull requests and shared by pulling.

Get started

  1. Install Dartmole

    Open the DMG and drag Dartmole to Applications. It starts its proxy as soon as it opens.

  2. Add the plugin to your app

    In pubspec.yaml:

    dependencies:
  dartmole_plugin: ^0.1.0

    Or run flutter pub add dartmole_plugin. It is on pub.dev.

    Give your HTTP library Dartmole().createHttpClient(), and put DartmoleSettings in a debug menu so testers can pair.

  3. Pair

    In Dartmole, open Devices. On the phone, tap Scan QR code. The phone and the Mac need to be on the same network.

Read the full guide: platform setup, Dio and http, mocks →