Swiftpack.co - Package - NozeIO/MicroExpress


Swift 4 Swift 5 macOS tuxOS Travis

A micro server framework on top of Swift NIO.

It adds an Express like API on top of the low level Swift NIO API.

import MicroExpress

let app = Express()

app.get("/moo") { req, res, next in
app.get("/json") { _, res, _ in
  res.json([ "a": 42, "b": 1337 ])
app.get("/") { _, res, _ in


This package is part of the Always Right Institute's blog series about the Swift Server Workgroup's offical Swift HTTP API.

Please checkout Part 3 of our blog series to learn what this is about. This is a tiny framework, for a more full featured, synchronous Express-like API in Swift, have a look at ExExpress (as used in ApacheExpress). Noze.io comes w/ an asynchronous variant (but is using Dispatch, not Swift NIO - stay tuned).

Using the Package

Micro Hello World in 5 minutes (or in 30s using the swift-xcode image below):

$ mkdir MicroHelloWorld && cd MicroHelloWorld
$ swift package init --type executable

Update Package.swift to include the dependency:

// swift-tools-version:4.0
import PackageDescription

let package = Package(
  name: "MicroHelloWorld",
  dependencies: [
    .package(url: "https://github.com/NozeIO/MicroExpress.git", 
             from: "0.4.4")
  targets: [
    .target(name: "MicroHelloWorld",
            dependencies: [ "MicroExpress" ])

Change the main.swift from print("Hello World") into:

import MicroExpress

let app = Express()

app.get("/") { req, res, next in
  res.send("Hello World")

$ swift build
$ swift run

Done. Access via: http://localhost:1337/

Building the Package


Choose the easy way using the swift-xcode Swift NIO image, or take the hard way and use swift package generate-xcodeproj.


brew install swiftxcode/swiftxcode/swift-xcode-nio
swift xcode link-templates # <-- important!
  1. Create new project (Command-Shift-N or File/New/Project ...)
  2. choose macOS / Server / Swift NIO template
  3. check desired options
  4. build and run, and then have fun!

swift package generate-xcodeproj

Important: This creates a few schemes in the Xcode project. Make sure to select the right one when building & running.

$ swift package generate-xcodeproj
Fetching ...
Cloning ...
Resolving ...
generated: ./MicroExpress.xcodeproj

$ open MicroExpress.xcodeproj

macOS /Linux Command Line

$ swift build
Fetching ...
Cloning ...
Resolving ...
Compile ...
Compile Swift Module ...
Compile Swift Module 'MicroExpress' (9 sources)
Linking ./.build/x86_64-apple-macosx10.10/debug/MicroExpress

Linux via macOS Docker

$ docker run --rm \
  -v "${PWD}:/src" \
  -v "${PWD}/.docker.build:/src/.build" \
  swift:4.0.3 \
  bash -c 'cd /src && swift build'
Unable to find image 'swift:4.0.3' locally
4.0.3: Pulling from library/swift
8f7c85c2269a: Pull complete 
9783e1c76d2b: Pull complete 
Digest: sha256:6978675b95f749b54eab57163c663d45b25c431c6d50cb5b2983062a55cea3c6
Status: Downloaded newer image for swift:4.0.3
Compile ...
Compile Swift Module ...
Compile Swift Module 'MicroExpress' (9 sources)
Linking ./.build/x86_64-unknown-linux/debug/MicroExpress
Fetching ...
Cloning ...
Resolving ...

$ file .docker.build/x86_64-unknown-linux/debug/MicroExpress
  ELF 64-bit LSB executable, x86-64, version 1 (SYSV), dynamically linked ...



MicroExpress is brought to you by the Always Right Institute and ZeeZide. We like feedback, GitHub stars, cool contract work, presumably any form of praise you can think of.

There is a #microexpress channel on the Noze.io Slack. Feel free to join!

Want a Video Tutorial?


Stars: 51
Help us keep the lights on


0.4.8 - Mar 15, 2019

Update to changes in NIO 2's API. Properly close contexts on error as suggested in issue #8.

0.4.7 - Jan 30, 2019

Support for Swift 5 and NIO 2 (master). Compiles w/ both, NIO1 and NIO2 and Swift 4...5.

0.2.0 - Mar 12, 2018

The release accompanying our "A µTutorial on Swift NIO" blog post.

A asynchronous micro-framework on top of Swift NIO: featuring middleware, routing, JSON and CORS support in about 350 lines of code.