168 lines
6.4 KiB
Markdown
168 lines
6.4 KiB
Markdown
# Angel3 Framework
|
|
|
|
[](https://github.com/dukefirehawk/angel)
|
|
|
|
|
|
[](https://dart.dev/null-safety)
|
|
[](https://gitter.im/angel_dart/discussion)
|
|
[](https://github.com/dukefirehawk/angel/LICENSE)
|
|
[](https://github.com/invertase/melos)
|
|
|
|
**A polished, production-ready backend framework in Dart with NNBD support.**
|
|
|
|
-----
|
|
|
|
## About
|
|
|
|
Angel3 is a fork of archived Angel framework to support Dart SDK 2.12.x or later. It is a full-stack Web framework in Dart that aims to streamline development by providing many common features out-of-the-box in a consistent manner. One of the main goal is to enable developers to build both frontend and backend in the same language, Dart. Angel3 framework is designed as a collection of plugins that enable developers to pick and choose the parts needed for their projects. A series of starter templates are also provided for quick start and trial run with Angel3 framework. Visit our [website](<https://angel3-framework.web.app/>) to learn more.
|
|
|
|
The available features in Angel3 includes:
|
|
|
|
* Server-Side Rendering (Markdown, Mustache, Jinja, JAEL)
|
|
* OAuth2 Authentication
|
|
* WebSocket
|
|
* HTTP/2
|
|
* HTTP Streaming
|
|
* GraphQL
|
|
* ORM for PostgreSQL
|
|
* ORM for MySQL
|
|
* MongoDB
|
|
* Cache
|
|
|
|
See all the available [`packages`](https://angel3-docs.dukefirehawk.com/packages) for more information.
|
|
|
|
## Important Notes
|
|
|
|
The core Angel Framework migration to Angel3 Framework has completed and published under `angel3_` prefix on pub.dev. The migrated packages have passed all the test cases. The development work will now move onto the next phase which is to refactor and to improve on the features for better development and deployment experience.
|
|
|
|
The status of the code base is as follows:
|
|
|
|
Branch: `master`
|
|
|
|
* Dart version : 2.17.x or later.
|
|
* Publish : Yes. Refer to packages with `angel3_` prefix on [pub.dev](https://pub.dev/publishers/dukefirehawk.com/packages).
|
|
* Null Safety : Yes
|
|
* Status : Production
|
|
* Notes : Use this branch for all PR submission
|
|
|
|
For more details, checkout [Project Status](https://github.com/dukefirehawk/angel/wiki/Project-Status)
|
|
|
|
## Release Notes
|
|
|
|
### Release 8.0.0 (Next Release)
|
|
|
|
* Update all `angel3_` packages to require dart >= 3.0.x
|
|
* Resolve issues related to generated container
|
|
* Improve HTTP and ORM performances
|
|
* Improve ORM for MySQL
|
|
* Add cache support to ORM (using Redis)
|
|
|
|
### Release 7.0.0 (Current Release)
|
|
|
|
* Updated all `angel3_` packages to require dart >= 2.17.x
|
|
* Updated dependencies to the latest libraries
|
|
* Fix ORM issues
|
|
* Fix `dart analyze .` warnings
|
|
|
|
### Release 6.0.0 (Previous Release)
|
|
|
|
* Update all `angel3_` packages to 6.0.0
|
|
* Update all `angel3_` packages to require dart >= 2.16.x
|
|
* Update ORM to support MariaDB 10.2.x (stable) and MySQL 8.x (beta)
|
|
* Update code generator to use `analyzer` 3.x.x
|
|
* Update exception handling
|
|
* Added default logger to generate standardised logging messages
|
|
* Added `melos` support
|
|
* Removed deprecated API
|
|
* [**Breaking**] `error` for `AngelHttpException` is no longer mandatory
|
|
|
|
## Installation and Setup
|
|
|
|
### Create a new project by cloning from boilerplate templates
|
|
|
|
1. Download and install [Dart](https://dart.dev/get-dart)
|
|
|
|
2. Clone one of the following starter projects:
|
|
* [Angel3 Basic Template](https://github.com/dukefirehawk/boilerplates/tree/v7/angel3-basic)
|
|
* [Angel3 ORM Template](https://github.com/dukefirehawk/boilerplates/tree/v7/angel3-orm)
|
|
* [Angel3 ORM MySQL Template](https://github.com/dukefirehawk/boilerplates/tree/v7/angel3-orm-mysql)
|
|
* [Angel3 Graphql Template](https://github.com/dukefirehawk/boilerplates/tree/v7/angel3-graphql)
|
|
|
|
3. Run the project in development mode (*hot-reloaded* is enabled on file changes).
|
|
|
|
```bash
|
|
dart --observe bin/dev.dart
|
|
```
|
|
|
|
4. Run the project in production mode (*hot-reloaded* is disabled).
|
|
|
|
```bash
|
|
dart bin/prod.dart
|
|
```
|
|
|
|
5. Run as docker. Edit and build the image with the provided `Dockerfile` file.
|
|
|
|
6. Next, refer to the [developer guide](https://angel3-docs.dukefirehawk.com/) to learn more about Angel3 framework.
|
|
|
|
### Create a new project with Angel3 CLI
|
|
|
|
1. Download and install [Dart](https://dart.dev/get-dart)
|
|
|
|
2. Install the [Angel3 CLI](https://pub.dev/packages/angel3_cli):
|
|
|
|
```bash
|
|
dart pub global activate angel3_cli
|
|
```
|
|
|
|
3. On terminal, create a new project:
|
|
|
|
```bash
|
|
angel3 init hello
|
|
```
|
|
|
|
4. Run the project in development mode (*hot-reloaded* is enabled on file changes).
|
|
|
|
```bash
|
|
dart --observe bin/dev.dart
|
|
```
|
|
|
|
5. Run the project in production mode (*hot-reloaded* is disabled).
|
|
|
|
```bash
|
|
dart bin/prod.dart
|
|
```
|
|
|
|
6. Run as docker. Edit and build the image with the provided `Dockerfile` file.
|
|
|
|
7. Next, refer to the [developer guide](https://angel3-docs.dukefirehawk.com/) to learn more about Angel3 framework.
|
|
|
|
### Migrating from Angel to Angel3
|
|
|
|
Check out [Migrating to Angel3](https://angel3-docs.dukefirehawk.com/migration/angel-2.x.x-to-angel3/migration-guide-3)
|
|
|
|
## Performance Benchmark
|
|
|
|
The performance benchmark can be found at
|
|
|
|
[TechEmpower Framework Benchmarks Round 21](https://www.techempower.com/benchmarks/#section=data-r21&test=composite)
|
|
|
|
The test cases are build using standard `Angel3 ORM` template. The result are used for fine-tuning Angel3 framework. The following test cases will be added in the upcoming update to the benchmark.
|
|
|
|
1. Cached queries
|
|
2. Angel3 with MongoDB
|
|
|
|
## Examples and Documentation
|
|
|
|
Visit the [User Guide](https://angel3-docs.dukefirehawk.com/) for dozens of guides and resources, including video tutorials, to get up and running as quickly as possible with Angel3 framework.
|
|
|
|
Examples and complete projects can be found [here](https://github.com/dukefirehawk/angel3-examples).
|
|
|
|
You can also view the [Angel3 API](http://www.dartdocs.org/documentation/angel_framework/latest).
|
|
|
|
## Contributing
|
|
|
|
Interested in contributing to Angel3? See the contribution guide [here](CONTRIBUTING.md).
|
|
|
|
## Donation & Support
|
|
|
|
If you like this project and interested in supporting its development, you can make a donation via [paypal](https://paypal.me/dukefirehawk?country.x=MY&locale.x=en_US) service.
|