here

local static server

everything start from here

FEATURE

• look up available port automatically, which means multiple instances without specifying port

• custom routes by scripting here.js

• live reload

• support https

• add ip address to your server, which makes your server available to other devices

• resolve get, post... every method into local files, for ajax

• respond files without extension as application/json for ajax

• open default browser after server launched

• when the server is on, press enter will open the browser

INSTALLATION

[sudo] npm install -g @vivaxy/here

USAGE

In your local folder, type here and it goes!

ADVANCED USAGE

specify port to 8888

here -p 8888

or

here --port 8888

default port is 3000

switch protocol to https

here -S

or

here --ssl

specify server root directory

here -d test

or

here --directory test

default directory is ./

watch file changes, once files changed, reload pages

here -w 3

or

here --watch

default interval is 0 second

recommend to set reload interval to page reload time

do not open the browser

here -s

or

here --silent

output log

here -l

or

here --log 0

middleware support

write here.js in server base directory

let db = {
    tobi: {
        name: 'tobi',
        age: 21
    },
    loki: {
        name: 'loki',
        age: 26
    },
    jane: {
        name: 'jane',
        age: 18
    }
};

module.exports = [
    {
        method: 'get',
        path: '/pets',
        data () {
            let names = Object.keys(db);
            return names.map((name) => {
                return db[name];
            });
        }
    },
    {
        method: 'get',
        path: '/pets/:name',
        data () {
            let name = this.params.name;
            let pet = db[name];
            if (!pet) {
                return {
                    error: `cannot find pet ${name}`
                };
            } else {
                return pet;
            }
        }
    }
];

see koa-router document for more detail

Prior Art

• puer not support post, respond files without extension as application/octet-stream

• anywhere not support post, and not support reload

• browsersync not support post, respond files without extension as application/octet-stream

Change Log

Change Log

Contributing

Contributing