Skip to main content
This quickstart builds the smallest useful Archery application: a configured App, one route, an HTTP kernel, and a dart:io server.
Complete Installation first. The example assumes Archery is installed and lib/src/config/server.json exists.

Create the server entry point

Create bin/server.dart:
The framework entry point exports the Archery types used here together with the required dart:io types.

Start the application

You should see:
In another terminal, request the health endpoint:
The server returns:

What the server is doing

  1. AppConfig.create() loads JSON configuration from lib/src/config.
  2. The configuration repository is registered as an eager singleton.
  3. app.boot() prepares the framework and its registered providers.
  4. Router records the GET /health handler.
  5. StaticFilesServer receives the first opportunity to serve a public asset.
  6. AppKernel sends every remaining request through middleware and route dispatch.
Keep the listener on InternetAddress.loopbackIPv4 when a local reverse proxy will expose the application. Public binding and production hardening are covered in Deployment.

Project structure

Organize routes, views, configuration, and application code.

Architecture

Understand what happens during startup and each request.