# webappengine

> A web application server that can host multiple web apps running with Node.js.

Latest version **1.2.0** (published 2017-06-22) · MIT license · 0 weekly downloads

## Install

```sh
npm install webappengine
pnpm add webappengine
yarn add webappengine
bun add webappengine
```

Provides the command `webappengine`.

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.2.0 |
| Published | 2017-06-22 |
| First published | 2015-08-06 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >=0.10.x |
| Dependencies | 26 |
| Known vulnerabilities | 0 (+15 in 7 direct dependencies) |
| Install scripts | no |
| Author | Cheton Wu |
| Maintainers | cheton |
| Keywords | webappengine |

## Links

- npm: https://www.npmjs.com/package/webappengine
- Repository: https://github.com/cheton/webappengine
- Issues: https://github.com/cheton/webappengine/issues
- npm.io page: https://npm.io/package/webappengine

## Dependencies (26)

- [del](https://npm.io/package/del.md) ~3.0.0
- [chalk](https://npm.io/package/chalk.md) ~1.1.3
- [jsuri](https://npm.io/package/jsuri.md) ~1.3.1
- [lodash](https://npm.io/package/lodash.md) ~4.17.4
- [morgan](https://npm.io/package/morgan.md) ~1.8.2
- [express](https://npm.io/package/express.md) ~4.15.3
- [i18next](https://npm.io/package/i18next.md) ~8.4.2
- [winston](https://npm.io/package/winston.md) ~2.3.1
- [hogan.js](https://npm.io/package/hogan.js.md) ~3.0.2
- [commander](https://npm.io/package/commander.md) ~2.9.0
- [multihost](https://npm.io/package/multihost.md) ~0.1.1
- [multiparty](https://npm.io/package/multiparty.md) ~4.1.3
- [body-parser](https://npm.io/package/body-parser.md) ~1.17.2
- [compression](https://npm.io/package/compression.md) ~1.6.2
- [consolidate](https://npm.io/package/consolidate.md) ~0.14.5
- [errorhandler](https://npm.io/package/errorhandler.md) ~1.5.0
- [serve-static](https://npm.io/package/serve-static.md) ~1.12.3
- [cookie-parser](https://npm.io/package/cookie-parser.md) ~1.4.3
- [serve-favicon](https://npm.io/package/serve-favicon.md) ~2.4.3
- [express-session](https://npm.io/package/express-session.md) ~1.15.3
- [method-override](https://npm.io/package/method-override.md) ~2.3.9
- [connect-multiparty](https://npm.io/package/connect-multiparty.md) ~2.0.0
- [connect-restreamer](https://npm.io/package/connect-restreamer.md) ~1.0.3
- [session-file-store](https://npm.io/package/session-file-store.md) ~1.0.0
- [i18next-node-fs-backend](https://npm.io/package/i18next-node-fs-backend.md) ~1.0.0
- [i18next-express-middleware](https://npm.io/package/i18next-express-middleware.md) ~1.0.5

## Recent versions

- 1.2.0 (latest) — 2017-06-22
- 1.1.3 — 2016-11-17
- 1.1.2 — 2016-06-12
- 1.1.1 — 2016-06-07
- 1.1.0 — 2016-05-12
- 1.0.0 — 2016-05-06
- 0.8.4 — 2016-04-29
- 0.8.3 — 2016-04-28
- 0.8.2 — 2016-04-28
- 0.8.1 — 2016-04-23
- 0.8.0 — 2016-04-12
- 0.7.1 — 2016-01-21
- 0.7.0 — 2016-01-14
- 0.6.3 — 2015-12-09
- 0.6.2 — 2015-09-09
- … 23 more at https://npm.io/package/webappengine/versions

## README

# WebAppEngine [![build status](https://travis-ci.org/cheton/webappengine.svg?branch=master)](https://travis-ci.org/cheton/webappengine) [![Coverage Status](https://coveralls.io/repos/cheton/webappengine/badge.svg?branch=master&service=github)](https://coveralls.io/github/cheton/webappengine?branch=master)

[![NPM](https://nodei.co/npm/webappengine.png?downloads=true&stars=true)](https://www.npmjs.com/package/webappengine)

A web application server that can host multiple web apps running with Node.js.

![WebAppEngine](https://raw.githubusercontent.com/cheton/webappengine/master/media/screenshot.png)
<i>Note. The administration UI is currently under construction.</i>

## Installation
For the API usage:
```bash
$ npm install --save webappengine
```

For the command line usage:
```bash
$ npm install -g webappengine
```

### Kickstart your project using [generator-webappengine](https://github.com/cheton/generator-webappengine)
A Yeoman generator for developing WebAppEngine app is available at [https://github.com/cheton/generator-webappengine](https://github.com/cheton/generator-webappengine). You can use the generator to kickstart your project. It includes Gulp, Browserify, Babelify, Stylus, Handlebars, i18next, and React.

Follow the steps to run the generator:
```bash
$ npm install -g yo
$ npm install -g generator-webappengine
$ yo webappengine
```

Once completed, you have to install NPM packages and Bower components, and run the `gulp` command to build your project.
```bash
$ npm install
$ bower install
$ gulp
```

Now you can run `node app/main.js` to launch your web app, or use webappengine to load [app.js](https://github.com/cheton/generator-webappengine/blob/master/generators/app/templates/app/app.js). For example:
```js
var path = require('path');
var webappengine = require('webappengine');

webappengine({
    port: 80,
    routes: [
        {
            type: 'server',
            route: '/',
            server: function(options) {
                options = options || {};

                var app = express();
                var serveStatic = require('serve-static');
                var assetPath = path.resolve(__dirname, 'web');
                
                app.use(options.route, serveStatic(assetPath));

                return app;
            }
        }
    ]
});
```

## Usage

### API usage
```js
var path = require('path');
var webappengine = require('webappengine');
var options = {
    port: 80, // [optional] The listen port (default: 8000)
    //host: '', // [optional] The listen address or hostname (default: 0.0.0.0)
    //backlog: 511, // [optional] The listen backlog (default: 511)
    routes: [
        {
            type: 'static', // [static|server]
            route: '/',
            directory: path.resolve(__dirname, 'web') // for the static type
        }
    ]
};

webappengine(options)
    .on('ready', function(server) {
        var address = server.address();
        console.log('Server is listening on %s:%d', address.address, address.port);

        var io = require('socket.io')(server); // using socket.io
    })
    .on('error', function(err) {
        console.error('Error:', err);
    });
```

### Command line usage
Run `webappengine` to start the app, and visit `http://yourhostname:8000/` to check if it works:

```bash
$ webappengine
```

To check what port the app is running on, find the message `Server is listening on 0.0.0.0:8000` from console output.

By default the app listens on port 8000, you can run `webappengine` with `-p` (or `--port`) to determine which port your application should listen on. For example:
```bash
$ webappengine -p 80
```

Set the environment variable `NODE_ENV` to `production` if you are running in production mode:
```bash
$ NODE_ENV=production webappengine
```

Run `webappengine` with `-h` for detailed usage:
```
$ webappengine -h

  Usage: webappengine [options]
  
  Options:

    -h, --help               output usage information
    -V, --version            output the version number
    -p, --port               set listen port (default: 8000)
    -H, --host <host>        set listen address or hostname (default: 0.0.0.0)
    -b, --backlog            set listen backlog (default: 511)
    -c, --config <filename>  set multihost configuration file
    -v, --verbose            increase the verbosity level
```

## Getting Started

### Working with static assets
The following configuration will serve static assets from the directory:

static-config.json:
```json
[
    {
        "type": "static",
        "route": "/",
        "directory": "/path/to/your/project/web/"
    }
]
```

Run `webappengine` with `--config` to set multihost configuration file:
```bash
$ webappengine --config "/path/to/your/project/static-config.json"
```

or use the API:
```js
var webappengine = require('webappengine');
var routes = require('./static-config.json');

webappengine({
    routes: routes
});
```

Visits `http://yourhostname:8000/` will serve `index.html` file as below:
```
<h1>WebAppEngine Test Page</h1>
```
(See also: [examples/static/index.html](examples/static/index.html))

### Configure multihost settings to run multiple web apps
First, checkout [examples/simple/app.js](examples/simple/app.js) and [examples/multihost.json](examples/multihost.json), and copy [examples](examples) to your project folder to kickstart a web application.

simple/app.js:
```js
var path = require('path'),
    express = require('express');

module.exports = function(options) {
    options = options || {};

    var app = express();
    var serveStatic = require('serve-static');
    var assetPath = path.resolve(__dirname, 'web');

    // Enable case sensitivity routing: "/Foo" is not equal to "/foo"
    app.enable('case sensitive routing');
    // Disable strict routing: "/foo" and "/foo/" are treated the same
    app.disable('strict routing');

    app.use(options.route, serveStatic(assetPath));

    return app;
};
```

server-config.json:
```json
[
    {
        "type": "server",
        "route": "/simple",
        "server": "/path/to/your/project/simple/app"
    }
]
```

Run `webappengine` with `--config` to set multihost configuration file:
```bash
$ webappengine --config "/path/to/your/project/server-config.json"
```

or use the API:
```js
var webappengine = require('webappengine');
var routes = require('./server-config.json');

webappengine({
    routes: routes
});
```

Visits `http://yourhostname:8000/simple` will serve `index.html` file as below:
```
<h1>WebAppEngine Test Page</h1>
```
(See also: [examples/simple/web/index.html](examples/simple/web/index.html))

## Administration UI
<i>The administration UI is currently under construction.</i>
### Dashboard
TBD
### Change the display language
You can change the display language from the <b>Settings</b> menu, it will set the `lang` query string parameter: `?lang={locale}`

Here is a list of currently supported locales:

Locale | Language
------ | --------
de     | Deutsch
en     | English (US)
es     | Español
fr     | Français
it     | Italiano
ja     | 日本語
zh-cn  | 中文 (简体)
zh-tw  | 中文 (繁體)

## License

Copyright (c) 2015-2016 Cheton Wu

Licensed under the [MIT License](LICENSE).

---
_Source: https://npm.io/package/webappengine · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._