This documentation is a work in progress

local-web-server

The modular web server for productive full-stack development.

Use this tool to:

• Build a fast, modern web application using any tech, framework or architecture.
• Prototype back-end services (RESTful HTTP API, Microservice, websocket server etc.)

Essentially, local-web-server is the lws command-line web server with a middleware stack built in offering the following features:

• Static file serving
• Single Page Application support
• Response mocking
• Configurable access log
• URL Rewriting, to local or remote destinations
• Request body parsing
• Route blacklisting
• HTTP Conditional Request support (cacheing)
• MIME-type customisation
• Gzip response compression
• Directory listing support

Synopsis

This package installs the ws command-line tool. The most simple use case is to run ws without any arguments - this will host the current directory as a static web site.

$ ws
Serving at http://mbp.local:8000, http://127.0.0.1:8000, http://192.168.0.100:8000

Opening any of the listed URLs in your browser will open your home page (index.html by default) if one exists, else show a directory listing.

Advanced Usage

Being modular and extensible, features can be added or removed from ws in the shape of Middleware, ServerFactory or View modules. See the wiki for full documentation and tutorials.

Install

Requires node v7.6 or higher. Install the previous release for node >= v4.0.0.

$ npm install -g local-web-server@next

---

© 2013-17 Lloyd Brookes 75pound@gmail.com. Documented by jsdoc-to-markdown.