Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sthnaqvi/http-webnode
A simple zero-configuration command-line static web server with custom error file, also serve single page application like angular 2/4/5 over http/https.
https://github.com/sthnaqvi/http-webnode
Last synced: about 1 month ago
JSON representation
A simple zero-configuration command-line static web server with custom error file, also serve single page application like angular 2/4/5 over http/https.
- Host: GitHub
- URL: https://github.com/sthnaqvi/http-webnode
- Owner: sthnaqvi
- License: mit
- Created: 2018-03-01T05:34:22.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2022-12-06T16:55:59.000Z (about 2 years ago)
- Last Synced: 2024-11-11T22:00:04.333Z (about 2 months ago)
- Language: JavaScript
- Size: 907 KB
- Stars: 2
- Watchers: 3
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://travis-ci.org/sthnaqvi/http-webnode)
[](https://david-dm.org/sthnaqvi/http-webnode)
[](https://www.npmjs.com/package/http-webnode)
[](https://github.com/sthnaqvi/http-webnode)
# http-webnode: a command-line static web server
`http-webnode` is a simple, zero-configuration command-line static web server with custom error file, also serve single page application like angular 2/4/5 over http/https. It is powerful enough for production usage, but it's simple and hackable enough to be used for testing, local development, and learning.
# Installing globally:
Installation via `npm`:
npm install http-webnode -g
This will install `http-webnode` globally so that it may be run from the command line.
## Usage:
http-webnode [path] [options]
`[path]` defaults to `./public` if the folder exists, and `./` otherwise.
*Now you can visit http://localhost:8080 to view your server*
**Note:** If you serve single page application like Angular 2/4/5. Add `-n index` to serve successfully.
**Note:** Caching is on by default. Add `-c-1` as an option to disable caching.
## Available Options:
`-p` Port to use (defaults to 8080)
`-a` Address to use (defaults to 0.0.0.0)
`-d` Show directory listings (defaults to 'True')
`-n` Error filename without .html (defaults to 404, redirect to 404.html)
`-i` Display autoIndex (defaults to 'True')
`-g` or `--gzip` When enabled (defaults to 'False') it will serve `./public/some-file.js.gz` in place of `./public/some-file.js` when a gzipped version of the file exists and the request accepts gzip encoding.
`-e` or `--ext` Default file extension if none supplied (defaults to 'html')
`-s` or `--silent` Suppress log messages from output
`--cors` Enable CORS via the `Access-Control-Allow-Origin` header
`-o` Open browser window after starting the server
`-c` Set cache time (in seconds) for cache-control max-age header, e.g. -c10 for 10 seconds (defaults to '3600'). To disable caching, use -c-1.
`-U` or `--utc` Use UTC time format in log messages.
`-P` or `--proxy` Proxies all requests which can't be resolved locally to the given url. e.g.: -P http://someurl.com
`-S` or `--ssl` Enable https.
`-C` or `--cert` Path to ssl cert file (default: cert.pem).
`-K` or `--key` Path to ssl key file (default: key.pem).
`-r` or `--robots` Provide a /robots.txt (whose content defaults to 'User-agent: *\nDisallow: /')
`-h` or `--help` Print this list and exit.
# Development
Checkout this repository locally, then:
```sh
$ npm i
$ node bin/http-webnode
```
*Now you can visit http://localhost:8080 to view your server*
You should see the turtle image in the screenshot above hosted at that URL. See
the `./public` folder for demo content.