s1

0.2.2 • Public • Published

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.

Dependents (0)

Package Sidebar

Install

npm i s1

Weekly Downloads

0

Version

0.2.2

License

MIT

Unpacked Size

7.12 kB

Total Files

6

Last publish

Collaborators

  • raidendev