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
|
|
|
|
|
This is a port of Angel Framework to work with Dart 2.10.x and above. Dart version below 2.10.x is not supported.
|
2021-03-13 02:00:29 +00:00
|
|
|
|
|
|
|
|
Branch: sdk-2.10.x
|
|
|
|
|
- Support dart 2.10.x only. Use sdk: ">=2.10.0 <2.12.0"
|
|
|
|
|
- Status: Working. Not all plugin packages are tested.
|
|
|
|
|
|
|
|
|
|
Branch: sdk-2.12.x
|
|
|
|
|
- Support dart 2.12.x. Use sdk: ">=2.10.0 <3.0.0"
|
|
|
|
|
- Do not support NNBD
|
|
|
|
|
- Status: Working. Not all plugin packages are migrated and tested.
|
|
|
|
|
|
2021-03-13 02:12:24 +00:00
|
|
|
Branch: adk-2.12.x-nnbd
|
2021-03-13 02:00:29 +00:00
|
|
|
- Support dart 2.12.x. Use sdk: ">=2.12.0 <3.0.0"
|
|
|
|
|
- Support NNBD
|
|
|
|
|
- Status: To be available once all the dependency libraries support NNBD
|
|
|
|
|
|
|
|
|
|
New features planned
|
|
|
|
|
- None
|
|
|
|
|
|
2021-03-13 02:12:24 +00:00
|
|
|
To install Angel CLI, run the following command after install dart sdk
|
|
|
|
|
`dart pub global activate --source git https://github.com/dukefirehawk/angel/packages/cli`
|
|
|
|
|
|
|
|
|
|
To use local development version of Angel CLI, run the following command after install dart sdk
|
|
|
|
|
`dart pub global activate --source path ./packages/cli`
|
|
|
|
|
|
|
|
|
|
|
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:
|
|
|
|
|
|
|
|
|
|
Install the [Angel CLI](https://github.com/angel-dart/cli):
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
pub global activate angel_cli
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
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
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Next, check out the [detailed documentation](https://docs.angel-dart.dev/v/2.x) to learn to flesh out your project.
|
|
|
|
|
|
2021-02-16 02:10:09 +00:00
|
|
|
## Development
|
|
|
|
|
|
|
|
|
|
* Install development version of Angel CLI
|
|
|
|
|
`dart pub global activate --source path ./packages/cli`
|
|
|
|
|
`dart pub global activate --source git https://github.com/dukefirehawk/angel/packages/cli`
|
|
|
|
|
|
2020-02-15 23:35:27 +00:00
|
|
|
## 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).
|
