Home

Local-web-server is a distribution of lws bundled with a "starter pack" of useful middleware.

The Basics

• Launch a simple HTTP development web server
• Launch a secure HTTPS development web server
  • How to get the "green padlock" using the built-in certificate
  • How to get the "green padlock" using a new self-signed certificate
  • How to proxy all HTTP requests to HTTPS
• How to launch a secure HTTP2 development web server
• Configuration Management
• Using middleware
• Verbose output
• How to distribute with your project
• How to use local-web-server programmatically (API Reference)
• CLI usage options

Tutorials

• How to serve a Single Page Application (SPA)
• How to rewrite URLs to local or remote destinations
• How to create a mock response
  • How to create an asynchronous mock response
  • How to mock a RESTful API
  • How to mock a Server-Sent Events (SSE) service
• How to output an access log
• How to visualise access logs with third-party tools
• How to blacklist certain routes
• How to customise mime types
• How to configure Cross-Origin Resource Sharing (CORS)
• How to use HTTP Conditional Requests
• How to password-protect a server using Basic Authentication

Extending

• How to create a middleware module
  • How to access the body of an incoming request
• How to create a websocket module

Plugins

• Plugin list