build Coverage Status Pub

A Dart and Flutter project automatic test runner to run tests automatically as files change. Inspired by Jest and Ruby's Guard.


Install sentinel globally so it won't cause conflicts with your dependencies.

$ pub global activate sentinel


On your Dart or Flutter project's root directory run:

$ sentinel

After that, when you change any file under lib and test directory, sentinel will automatically run a corresponding unit test if available or all tests.

Running Integration Tests

Warning: this feature is experimental.

If you wish to also run integration tests like in a flutter project, use the -i option.

$ sentinel -i

Ignoring Files

To ignore some files from watching, create a sentinel.yaml on your project root and add the ignored globs like the following:

  - test/tmp/*
  - data/schema.dart