Grinder for Dart

A task based, dependency aware build system.

Build Status Coverage Status


Grinder is a library and tool to drive a command-line build.

Build files are entirely specified in Dart code. This allows you to write and debug your build files with the same tools you use for the rest of your project source.

Getting Started

The build file for your application should reside at tool/grind.dart. A typical Grinder build file may look something like this:

void main([List<String> args]) {
  task('init', init);
  task('compile', compile, ['init']);
  task('deploy', deploy, ['compile']);
  task('docs', deploy, ['init']);
  task('all', null, ['deploy', 'docs']);


init(GrinderContext context) {
  context.log("I set things up");


Tasks to run are specified on the command line. If a task has dependencies, those dependent tasks are run before the specified task.


To install, run:

pub global activate grinder

Command-line usage

usage: dart grind.dart <options> target1 target2 ...

valid options:
-h, --help    show targets but don't build
-d, --deps    display the dependencies of targets


pub run grind <args>

will run the tool/grind.dart script with the supplied arguments.

API documentation

Documentation is available here.


This is not an official Google product.



A library and tool to drive a command-line build.


General file system routines, useful in the context of running builds. This includes the FileSet class, which is used for reasoning about sets of files.

Commonly used tools for build scripts, including for tasks like running the pub commands.