2020-02-15 23:35:27 +00:00
[](https://angel-dart.dev)
[](https://gitter.im/angel_dart/discussion)
[](https://pub.dartlang.org/packages/angel_framework)
[](https://travis-ci.org/angel-dart/framework)
**A polished, production-ready backend framework in Dart.**
-----
## About
Angel is a full-stack Web framework in Dart. It aims to
streamline development by providing many common features
out-of-the-box in a consistent manner.
With features like the following, Angel is the all-in-one framework you should choose to build your next project:
2020-02-15 23:36:29 +00:00
* GraphQL Support
* PostgreSQL ORM
* Dependency Injection
* Static File Handling
* And much more...
See all the packages in the `packages/` directory.
2020-02-15 23:35:27 +00:00
2021-03-13 02:12:24 +00:00
## IMPORTANT NOTES
2021-05-01 01:34:16 +00:00
This is a port of Angel Framework to work with Dart SDK 2.12.x and above. Dart SDK 2.12.x and below are not supported.
2021-03-13 02:00:29 +00:00
2021-03-13 02:32:48 +00:00
Branch: master
2021-05-01 01:34:16 +00:00
- Same as sdk-2.12.x branch
2021-03-13 02:00:29 +00:00
Branch: sdk-2.12.x
2021-05-01 01:34:16 +00:00
- Required Dart SDK: ">=2.10.0 < 3.0.0 "
- NNBD Support: No
- Status: Production
- Notes: Not all packages are fully tested. Refer to WIKI page for details. The Basic and ORM boilerplates are working and can be found at https://github.com/dukefirehawk/boilerplates under "basic-sdk-2.12.x" and "orm-sdk-2.12.x" branch respectively.
Branch: sdk-2.12.x_nnbd
- Required Dart SDK: ">=2.12.0 < 3.0.0 "
- NNBD Support: Yes
- Status: Development
- Notes: Migration and code refactoring in progress. Refer to WIKI page for details.
Branch: sdk-2.10.x
- Required Dart SDK: ">=2.10.0 < 2.12.0 "
- NNBD support: No
- Status: Retired
- Notes: Upgrade completed. Not all packages are fully tested. This branch is the baseline used in migrating the framework to Dart SDK 2.12.x. It may still work with Dart SDK 2.10.x but no longer maintained.
2021-03-13 02:12:24 +00:00
2020-02-15 23:35:27 +00:00
## Installation & Setup
Once you have [Dart ](https://www.dartlang.org/ ) installed, bootstrapping a project is as simple as running a few shell commands:
2021-03-13 02:50:14 +00:00
Install the [Angel CLI ](https://github.com/dukefirehawk/cli ):
2020-02-15 23:35:27 +00:00
```bash
2021-03-13 03:00:04 +00:00
pub global activate --source git https://github.com/dukefirehawk/cli.git
2020-02-15 23:35:27 +00:00
```
Bootstrap a project:
```bash
angel init hello
```
You can even have your server run and be *hot-reloaded* on file changes:
```bash
dart --observe bin/dev.dart
```
2021-03-13 03:00:04 +00:00
(For CLI development only)Install Angel CLI
```bash
pub global activate --source path ./packages/cli
```
2020-02-15 23:35:27 +00:00
Next, check out the [detailed documentation ](https://docs.angel-dart.dev/v/2.x ) to learn to flesh out your project.
## Examples and Documentation
Visit the [documentation ](https://docs.angel-dart.dev/v/2.x )
for dozens of guides and resources, including video tutorials,
to get up and running as quickly as possible with Angel.
Examples and complete projects can be found
[here ](https://github.com/angel-dart/examples-v2 ).
You can also view the [API Documentation ](http://www.dartdocs.org/documentation/angel_framework/latest ).
There is also an [Awesome Angel :fire: ](https://github.com/angel-dart/awesome-angel ) list.
2020-02-15 23:36:29 +00:00
## Contributing
Interested in contributing to Angel? Start by reading the contribution guide [here ](CONTRIBUTING.md ).
