platform/README.md

A polished, production-ready backend framework in Dart with NNBD support.

---

About

Angel3 is a port of the original Angel framework to support NNBD in Dart SDK 2.12.x and above. 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.

The availabe features in Angel3 are:

• Static File Handling
• Basic Authentication
• PostgreSQL ORM
• And much more...

See all the packages in the packages/ directory.

IMPORTANT NOTES

The migration of Angel Framework to Angel3 framework is still ongoing. About 35 out of 70++ packages have been migrated and tested to be stable and working as expected. Angel3 framework need more testing to get it to production quality. Hence, the Angel3 stable packages have been published with prefix angel3_ on pub.devfor developers to try out.

In order to acknowledge contributions, AUTHORS.md has been added to every Angel3 packages. This way no matter what the contributions are, be it code review, testing or submit PR, can all be recorded in this file. If you are the original author of the original Angel packages, feel free to send a PR to update that file.

Branch: master

• Stable version of angel3 branch

Branch: angel3 (Active development)

• Dart version : 2.12.x and above. Use sdk: ">=2.12.0 <3.0.0"
• Publish : Yes. See all packages with angel3_ prefix on pub.dev.
• NNDB Support : Yes
• Status : Beta
• Notes : Basic and ORM templates are working with the key packages migration completed. Not all packages are fully tested.

Branch: sdk-2.12.x-nnbd (Active development)

• Dart version : 2.12.x and above. Use sdk: ">=2.12.0 <3.0.0"
• Publish : No (Internal use only)
• NNDB Support : Yes
• Status : Beta
• Notes : Basic and ORM templates are working with key packages migration. Not all packages are fully tested.

For more details, checkout Project Status

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

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

(For CLI development only)Install Angel CLI

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

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

Migrating to Angel3 Framework

Checkout Migrating from Angel to Angel3

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.