3.0 Pre-release Note
This documentation is the 3.0 pre-release documentation for Aqueduct. It has not been finalized and is subject to change.
Installing Pre-release Aqueduct
You’ll need to upgrade to the developer release of Dart 2.0. On macOS, you install with Homebrew:
brew upgrade dart --devel
Once you have Dart 2.0, clone Aqueduct locally, switch to the 3.0 branch, and install the CLI from your local repository.
git clone https://github.com/stablekernel/aqueduct.git cd aqueduct git checkout 3.0 # Don't forget the dot at the end of the next command pub global activate -spath aqueduct
Move to another directory and create a new project that targets Aqueduct 3.
# Make sure you aren't in the aqueduct directory aqueduct create my_app
Because your project was created from a local version of Aqueduct, it’s pubspec.yaml file will point at that directory on your filesystem. To stay up to date with 3.0 (or to build remotely), change your pubspec.yaml file to reference the 3.0 branch on GitHub:
aqueduct: git: url: [email protected]:stablekernel/aqueduct.git ref: “3.0”
You can access the pre-release API reference here.
Aqueduct is a server-side framework for building and deploying REST applications. It is written in Dart.
Check out Snippets for quick code snippets to get you up and running faster.
Import this file into IntelliJ IDEA for Aqueduct file and code templates.
How to Use this Documentation
Each topic covers a major component of the Aqueduct framework and are displayed in the side menu. Within each topic, there is an overview page and a number of guides. Each guide contains example code, explanations and best practices for building Aqueduct applications.
Guides create an initial understanding and give context to the Aqueduct framework. The API reference details each type, property and method in the Aqueduct framework. The tutorial is a guided exercise that teaches the very basics of Aqueduct while creating a server application.