4.1 KiB
The Dart server framework that's ready for showtime.
Angel is a full-featured server-side Web application framework for the Dart programming language. It strives to be a flexible, extensible system, to be easily scalable, and to allow as much code to be shared between clients and servers as possible. Ultimately, I believe that this approach will shorten the time it takes to build a full-stack Web application, from start to finish. Read more...
Like what you see? Please lend us a star. ⭐
Installation & Setup
Having errors with a fresh Angel installation? See here for help.
Once you have Dart installed, bootstrapping a project is as simple as running one shell command:
Install the Angel CLI:
pub global activate angel_cli
Bootstrap a project:
angel init hello
You can even have your server run and be live-reloaded on file changes:
angel start
Next, check out the detailed documentation to learn to flesh out your project.
Features
With features like the following, Angel is the all-in-one framework you should choose to build your next project:
Basic Example
More examples and complete projects can be found in the angel-example organization.
The following is an explosive application complete with a REST API and
WebSocket support. It interacts with a MongoDB database, and reads configuration automatically from a config/<ANGEL-ENV-NAME>.yaml file. Templates are rendered with Mustache, and all responses are compressed via GZIP.
All in just about 20 lines of actual code.
import 'dart:async';
import 'package:angel_common/angel_common.dart';
import 'package:angel_websocket/server.dart';
import 'package:mongo_dart/mongo_dart.dart';
main() async {
var app = await createServer();
var server = await app.startServer(InternetAddress.LOOPBACK_IP_V4, 8080);
print('Angel listening at http://${server.address.address}:${server.port}');
}
Future<Angel> createServer() async {
// New instance...
var app = new Angel();
// Configuration
await app.configure(loadConfigurationFile());
await app.configure(mustache());
Db db = new Db();
await db.open(app.mongodb_url);
app.container.singleton(db); // Add to DI
// Routes
app.get('/foo', (req, res) => res.render('hello'));
app.post('/query', (Db db) async {
// Db is an injected dependency here :)
return await db.collection('foo').find().toList();
});
// Services (which build REST API's and are broadcasted over WS)
app.use('/bombs', new MongoService(db.collection('bombs')));
app.use('/users', new MongoService(db.collection('users')));
app.use('/explosions', new AnonymousService(create: (data, [params]) => data));
// Setup WebSockets, add GZIP, etc.
await app.configure(new AngelWebSocket(debug: true));
app.responseFinalizers.add(gzip());
return app;
}
Join the team
Do you want to collaborate? Join the project at https://projectgroupie.com/projects/212