Getting Started

Installation

Install Spry run this command:

dart pub add spry

Or, update your pubspec.yaml file:

dependencies:
  spry: <latest | ^{version}>

Quick Start

Creates a new file app.dart(or main.dart | server.dart):

app.dart

import 'dart:io';

import 'package:spry/spry.dart';
import 'package:spry/io.dart';

void main() async {
  // Create an Spry app instance.
  final app = Spry();

  // Add a new route that matches GET requests to / path
  app.get('/', (event) => "⚡️ Tadaa!");

  // Creates a HttpServer listen on data handler.
  final handler = const IOPlatform().createHandler(app);

  // Create an HttpServer.
  final server = await HttpServer.bind('127.0.0.1', 3000);

  // Listen requests of handler.
  server.listen(handler);

  print('🚀 HTTP server listen on http://127.0.0.1:3000');
}

Now run the development server using dart run:

dart run app.dart

And tadaa! We have a web server running locally.

What happened?

Okay, let's now break down our example:

We first created an [Spry application][/guide/app] using Spry(). app is a tiny server capable of matching requests, generating response and handling lifecycle hooks (such as errors):

final app = Spry();

Then we adds our first endpoint. in Spry, we define request handlers using a closure preceded by a FutureOr<T> Function(Event) type:

app.get('/', (event) => ...);

What is beautiful in Spry is that all you have to do to make a response, is to simply return it! Responses can be simple string, JSON objects, Uint8List or streams.

return '⚡️ Tadaa!';

We then use Spry’s built-in dart:io platform support to wrap the app instance into a handler that HttpServer can use:

final handler = const IOPlatform().createHandler(app);

Finally, we create an HTTP server from dart:io and listen for requests to pass to the Spry app:

final server = await HttpServer.bind('127.0.0.1', 3000);

server.listen(handler);