johancodinha/paperplane

Lighter-than-air node.js server framework

Lighter-than-air node.js server framework.

Documentation

• Getting started guide
• API docs

Introduction

The main goal of paperplane is to make building a node.js server easy, without all of the configuration or imperative boilerplate required for other server frameworks. If you prefer to build apps with function composition or even a point-free style, then paperplane is for you.

With paperplane you get all of these out-of-the-box:

• pure, functional, Promise-based route handlers
• composeable json body parsing
• dead-simple routing functions
• several common response helpers
• json-formatted logging
• easily configurable CORS support
• plug-n-play static file serving

Let's try a quick Hello World example server. It accepts a :name param in the url, and then includes that name in the json response body.

const { compose } = require('ramda')
const http = require('http')
const { json, logger, methods, mount, routes } = require('paperplane')

const hello = req => ({
  message: `Hello ${req.params.name}!`
})

const app = routes({
  `/hello/:name`: methods({
    GET: compose(json, hello)
  })
})

const opts = { errLogger: logger, logger }

http.createServer(mount(app, opts)).listen(3000, logger)

So simple and functional, with an easily readable routing table and pure functions for the route handler. If that sounds like fun to you, then read the Getting started guide or the API docs to learn more.