104 lines
4.2 KiB
Markdown
104 lines
4.2 KiB
Markdown
[](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:
|
|
* GraphQL Support
|
|
* PostgreSQL ORM
|
|
* Dependency Injection
|
|
* Static File Handling
|
|
* And much more...
|
|
|
|
See all the packages in the `packages/` directory.
|
|
|
|
## IMPORTANT NOTES
|
|
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.
|
|
|
|
Branch: master
|
|
- Same as sdk-2.12.x branch
|
|
|
|
Branch: sdk-2.12.x
|
|
- Required Dart SDK: ">=2.10.0 <3.0.0"
|
|
- NNBD Support: No
|
|
- Status: Beta release
|
|
- Notes: Not all packages are fully tested. Refer to WIKI page for details. The basic and ORM templates can be found at "https://github.com/dukefirehawk/boilerplates/tree/basic-sdk-2.12.x" and "https://github.com/dukefirehawk/boilerplates/tree/orm-sdk-2.12.x" respectively.
|
|
|
|
Branch: sdk-2.12.x_nnbd
|
|
- Required Dart SDK: ">=2.12.0 <3.0.0"
|
|
- NNBD Support: Yes
|
|
- Status: Alpha release
|
|
- Notes: Heavy migration and code refactoring in progress. Refer to WIKI page for details. The basic template can be found at https://github.com/dukefirehawk/boilerplates/tree/basic-sdk-2.12.x_nnbd".
|
|
|
|
Branch: sdk-2.10.x
|
|
- Required Dart SDK: ">=2.10.0 <2.12.0"
|
|
- NNBD support: No
|
|
- Status: Retired
|
|
- Notes: Not all packages are fully tested. This branch is the baseline used in migrating the framework to support Dart SDK 2.12.x and beyond. It may still work with Dart SDK 2.10.x but no longer maintained. Do not work with Dart SDK < 2.10.x.
|
|
|
|
## Starting a new project in Angel NNBD
|
|
1. Clone `https://github.com/dukefirehawk/boilerplates/tree/basic-sdk-2.12.x_nnbd` project.
|
|
|
|
## Migrating an existing project to Angel NNBD
|
|
1. WARNING. Backup your existing code first as the following migration process cannot be reversed.
|
|
2. Run `dart pub outdated --mode=null-safety`. Make sure all the packages besides "angel_*" are upgradable.
|
|
3. Update all "angel_*" packages with dependencies in `https://github.com/dukefirehawk/boilerplates/tree/basic-sdk-2.12.x_nnbd/pubspec.yaml` file. Refer to WIKI on the migrated Angel NNBD packages.
|
|
4. Run `dart pub upgrade --null-safety`.
|
|
5. Run `dart migrate` to perform the migration.
|
|
6. Fix and resolve NNDB related warnings and errors.
|
|
|
|
## 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/dukefirehawk/cli):
|
|
|
|
```bash
|
|
pub global activate --source git https://github.com/dukefirehawk/cli.git
|
|
```
|
|
|
|
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
|
|
```
|
|
|
|
(For CLI development only)Install Angel CLI
|
|
|
|
```bash
|
|
pub global activate --source path ./packages/cli
|
|
```
|
|
|
|
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.
|
|
|
|
## Contributing
|
|
Interested in contributing to Angel? Start by reading the contribution guide [here](CONTRIBUTING.md).
|