Node static page server for quickly getting MVVM running
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
Jonatan Nilsson 023f1852e9 1.1.1 1 year ago
.circleci circleci: Add automatic builds 5 years ago
lib ssl: Fix resolving path to builtin ssl certs if not overwritten 1 year ago
test General update, removed short-hand argument options, used newer smaller depencies, turned into ecmamodule script and generally made smaller 1 year ago
.gitignore Initial commit 8 years ago
.jshintrc many: Initial 0.1.0 version. 8 years ago
.npmrc General update, removed short-hand argument options, used newer smaller depencies, turned into ecmamodule script and generally made smaller 1 year ago
LICENSE many: Initial 0.1.0 version. 8 years ago
README.md General update, removed short-hand argument options, used newer smaller depencies, turned into ecmamodule script and generally made smaller 1 year ago
bin.mjs Added --version support 1 year ago
cert.pem Add support for running in ssl mode 1 year ago
key.pem Add support for running in ssl mode 1 year ago
package.json 1.1.1 1 year ago

README.md

spserver

spserver (or single page server) is a simple helper utlity for creating/running a server for using in pure single-page applications in true MVVM fashion without having to write any node code or using nginx or anything. This can be helpful to jump start making any single-page applications and get it running in seconds.

How it works

spserver has two modes of serving files (minimum either has to be specified):

  • Single file
  • Static folder

When specifying a single file, all url requests will resolve with the contents of said file. This is handy for MVVM applications where the front-end javascript handles all url path routing.

When specifying a static folder, it will first look up the url request on the static folder to see if the file exists. If it doesn't, it falls back to the single file (above) or 404 (if single file was not specified).

A combination of these two will allow you to create a single base.html that will bootstrap your MVVM application with the static folder containing the javascript files. For an example, see the nfp_www project.

API

spserver(settings)

  • Settings for the server (see config below)

CLI

How to use

npm install [-g] spserver
spserver --file ./myfile.html --serve ./public -p 3000

Options

spserver --help

By default, spserver will use the settings located in config.json. You can also override them or run it directly using only the commands below.

--config Location of the config file for the server [default: config.json]

--port The port server should bind to [default: 3001 or 80 in production mode]

--file Single static file the server should serve on all unknown requests

--bunyan Use bunyan instead of console to log to [default: true in production mode]

--template Parse the static file as lodash template with all options/settings being passed to it

--name The name for this server for logging [default: spserver]

--serve Folder path to serve static files from [default: public]

--prod Force run the server in production mode

--debug Force run the server in development mode

Config

The config file (default config.json) provides means to configure spserver in greater detail as well as provide optional settings to pass into our template (see template below).

A sample config.json file:

{
  "production": {
    "port": 80,
    "bunyan": {
      "name": "myserver",
      "use_bunyan": true,
      "streams": [{
        "file": "/var/log/server.log",
        "level": "info"
      }]
    }
  },
  "development": {
    "port": 5000,
    "use_bunyan": false
  }
}

Any of the settings in the config.json file can be overridden using the CLI options above.

Template

spserver can also help provide any additional info to your single file thanks to lodash: template. If template mode is specified, it will parse the single file first through lodash.template with the whole config file. This can allow you to specify configuration in your config file and expose them in your single file.

Example:

config.json

{
  "api": "http://api.mysite.com"
}

base.html

<!doctype html>
<body>
  <script>
    var apiUrl = "<%- api %>"
  </script>
  <script src="/js/lib/mithril.js"></script>
  <script src="/js/main.js"></script>
</body

Then you can run it like this: spserver --config ./config.json --template --file ./base.html --serve ./public