2021-06-22 08:17:15 +00:00
# Angel3 Framework
2023-10-18 23:48:24 +00:00
[](https://github.com/dukefirehawk/angel)
2023-10-18 14:21:24 +00:00
2021-09-25 06:32:32 +00:00
2021-05-14 10:34:09 +00:00
[](https://dart.dev/null-safety)
2021-05-15 06:18:06 +00:00
[](https://gitter.im/angel_dart/discussion)
2021-09-25 06:32:32 +00:00
[](https://github.com/dukefirehawk/angel/tree/master/packages/framework/LICENSE)
2022-03-20 00:55:30 +00:00
[](https://github.com/invertase/melos)
2016-06-21 22:56:04 +00:00
2021-08-20 05:46:02 +00:00
Angel3 framework is a high-powered HTTP server with support for dependency injection, sophisticated routing, authentication, ORM, graphql etc. It is designed to keep the core minimal but extensible through a series of plugin packages. It won't dictate which features, databases or web templating engine to use. This flexibility enable Angel3 framework to grow with your application as new features can be added to handle the new use cases.
2021-11-23 10:27:01 +00:00
This package is the core package of [Angel3 ](https://github.com/dukefirehawk/angel ). For more information, visit us at [Angel3 Website ](https://angel3-framework.web.app ).
2021-08-20 05:46:02 +00:00
2021-08-20 05:55:04 +00:00
## Installation and Setup
2021-08-20 05:46:02 +00:00
2021-08-20 05:55:04 +00:00
### (Option 1) Create a new project by cloning from boilerplate templates
2021-08-20 05:46:02 +00:00
1. Download and install [Dart ](https://dart.dev/get-dart )
2. Clone one of the following starter projects:
2022-09-18 16:58:28 +00:00
* [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 )
2021-08-20 05:46:02 +00:00
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.
2021-08-20 05:55:04 +00:00
### (Option 2) Create a new project with Angel3 CLI
2021-08-20 05:46:02 +00:00
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.
2022-10-03 15:31:46 +00:00
## Performance Benchmark
The performance benchmark can be found at
[TechEmpower Framework Benchmarks Round 21 ](https://www.techempower.com/benchmarks/#section=data-r21&test=composite )
2021-08-20 05:46:02 +00:00
### 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 )
2022-09-18 16:58:28 +00:00
## 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.
