s1 – Static server for SPA development
The light and simple node-way static server with mod_rewrite. Best suitable for single-page apps development but can be used to host anything static.
Please, avoid using it in production.
Using
Install via npm (preferred globally).
npm -g install s1
Go to your project's public assets directory and run s1
executable.
cd app/public && s1
Now open localhost:8080 and enjoy your work.
CLI options
$ s1 --help
Usage: s1 [options]
Options:
-h, --host, --ip Host or IP to bind [default: "0.0.0.0"]
-p, --port Port [default: 8080]
-d, --dir, --root Root directory [default: "./"]
-i, --index Index file [default: "index.html"]
-c, --config, --conf Config module [default: "./config"]
--help Show help [boolean]
Config
The config is the basic Node.js module exporting object.
It is located at s1's root directory, e.g., if installed globally in OS X /usr/local/lib/node_modules/s1/config.js
.
You can have as many configs as you want, store it where you want, and pass needed one to the s1 using -c
or --config
cli switch.
For example:
s1 --config ~/myapps/config.app1.js
Config options
All config options except rewrite
could be redefined from CLI.
Name | Type | Default | Description |
---|---|---|---|
host | String |
0.0.0.0 | Host or interface's IP address s1 will be bound to. By default binds to ALL interfaces. |
port | Number |
8080 | Binding port. |
dir | String |
./ | Root directory from which files will be hosted. Default to current directory. |
index | String |
index.html | Index file name. Your app's entry. |
rewrite | Array |
base rewrite | Array with rules for mod_rewrite engine. s1 uses connect-modrewrite which rules are similiar to classic mod_rewrite in Nginx or Apache. You can use s1's options in rules using {{property}} syntax. |
Contributing
The main purpose of the server is to stay tiny and easy to use in everyday development tasks. So if you got any use case you think is widely popular but poorly supported by s1 – feel free to tell me about it, or try to implement it yourself and send the PR.