This project is built with grinder. To install, please run:
$ dart pub global activate grinder
The dart-services v2 API is defined in terms of Protobuf, which requires the installation of the Protobuf
protoc compiler. Please see Protocol Buffers for detailed installation instructions. On macOS, you may also install with Homebrew via:
$ brew install protobuf
The Dart protoc plugin is also required for the above
protoc compiler to generate Dart code. To install, please run:
$ dart pub global activate protoc_plugin
The Flutter SDK needs to be downloaded and setup.
$ dart pub install $ dart run tool/update_sdk.dart stable
The Dart Services server depends on generated files. Run the following to generate all the required binaries.
$ FLUTTER_CHANNEL="stable" grind deploy
To run the server, run:
$ FLUTTER_CHANNEL="stable" grind serve
The server will run from port 8082 and export several JSON APIs, like
To run tests:
grind test for unit tests
grind deploy for all tests and checks.
dart-services requires the
redis package, including the
redis-server binary, to be installed to run tests.
sudo apt-get install redis-server will install this on Ubuntu, but see Redis' Quick Start guide for other platforms.
To deploy the server to Dart on AppEngine, follow the instructions here.
warmup.dart to point the BASE_URI to your AppEngine project.
The will deploy the server, and run the warmup sequence and sanity checks.
See also the dart-pad repo.
Please file reports on the GitHub Issue Tracker for DartPad.
Contributions welcome! Please read this short guide first. You can view our license here.