A quick and easy web server stub.

npm install easyquick
40 downloads in the last month


A quick and easy web server stub.


npm install easyquick -g


cd /path/to/my/sources

Starting parameters overview

p        a standard port different from 80
www        a static assets path different from current directory

s        set a service method script
u        a service url prefix different from 'service' (http://localhost/service/demo)

ws        use WebSockets

ssl        start with ssl support (on port 443)
h        a host name different from localhost (for ssl)

Usage of a service

To integrate a service, place a service script like this in your working directory and name it, e.g. service.js:

var serviceCallback = function (serviceName, postData, callback) {
    var responseData = {};
    switch (serviceName) {
        // call with http://localhost/service/demo
        case 'demo':
            responseData = {demo: 'hello'};
    return responseData;

exports.service = serviceCallback;

Refer to this script by starting with --s parameter. Services have a special path in your url (default is http://localhost/service). If you'd like to set a different path name, start with --u parameter:

easyquick --s=service --u=example/service        # run service with http://localhost/example/service

To call services from frontend you can copy jquery.service.js to your working directory. Adjust it to your needs and call it like that:

$(document).ready(function() {
    $.callService('demo', {}, function(response){
        // something inside the success callback..

Or do something else.


To use WebSockets, install socket.io first (npm install socket.io -g). After that start easyquick server with --ws flag.

easyquick --ws

Calling services from frontend is shown in example as well.

$(document).ready(function() {
        $(document).callSocket('hello', {id: '123'}, function (response) {
            // something inside the socket callback..

SSL support

To run easyquick server with ssl, install http-proxy first (npm install http-proxy -g) and start with --ssl parameter. Optionally set another host name with --h. SSL needs a (self-signed) ssl certificate. It has to be placed inside a folder named ssl in your working directory. Place here both files localhost.key and localhost.cert. Actually SSL is only supported on port 443.

easyquick --ssl --h "abc.de"
npm loves you