platform/README.md
2021-03-13 10:50:14 +08:00

3.2 KiB

The Angel Framework

Gitter Pub Build status License

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 2.10.x and above. Dart version below 2.10.x is not supported.

Branch: master

  • Stable version of sdk-2.12.x branch

Branch: sdk-2.10.x

  • Support dart 2.10.x only. Use sdk: ">=2.10.0 <2.12.0"
  • Status: Migration completed. 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: Basic and ORM templates are working with the core plugins migration completed. The remaining add on plugin packages are work in progress.

Branch: sdk-2.12.x-nnbd

  • Support dart 2.12.x. Use sdk: ">=2.12.0 <3.0.0"
  • Support NNBD
  • Status: Not working yet. To be available once all the dependency libraries that support NNBD are released

Changes involved:

  • Upgraded dependency libraries and fixed the deprecated API

Deprecated features:

  • None

New features:

  • To be decided

Installation & Setup

Once you have Dart installed, bootstrapping a project is as simple as running a few shell commands:

Install the Angel CLI:

`pub global activate --source git https://github.com/dukefirehawk/cli.git`

Install local development version of Angel CLI

pub global activate --source path ./packages/cli

Bootstrap a project:

angel init hello

You can even have your server run and be hot-reloaded on file changes:

dart --observe bin/dev.dart

Next, check out the detailed documentation to learn to flesh out your project.

Examples and Documentation

Visit the documentation 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.

You can also view the API Documentation.

There is also an Awesome Angel 🔥 list.

Contributing

Interested in contributing to Angel? Start by reading the contribution guide here.