Package Exports
- gulp-webserver
This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (gulp-webserver) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.
Readme
gulp-webserver 
Streaming gulp plugin to run a local webserver with LiveReload
Hint: This is a rewrite of gulp-connect
Install
$ npm install --save-dev gulp-webserverUsage
The gulp.src('root') parameter is the root directory of the webserver. Multiple directories are possible.
var gulp = require('gulp');
var webserver = require('gulp-webserver');
gulp.task('webserver', function() {
gulp.src('app')
.pipe(webserver({
livereload: true,
directoryListing: true,
open: true
}));
});Options
| Key | Type | Default | Description |
|---|---|---|---|
host |
String | localhost |
hostname of the webserver |
port |
Number | 8000 |
port of the webserver |
livereload |
Boolean/Object | false |
whether to use livereload. For advanced options, provide an object. You can use the 'port' property to set a custom live reload port and the filter function to filter out files to watch. |
directoryListing |
Boolean/Object | false |
whether to display a directory listing. For advanced options, provide an object with the 'enable' property set to true. You can use the 'path' property to set a custom path or the 'options' property to set custom serve-index options. |
fallback |
String | undefined |
file to fall back to (relative to webserver root) |
open |
Boolean/String | false |
open the localhost server in the browser. By providing a String you can specify the path to open. |
https |
Boolean/Object | false |
whether to use https or not. By default, gulp-webserver provides you with a development certificate but you remain free to specify a path for your key and certificate by providing an object like this one: {key: 'path/to/key.pem', cert: 'path/to/cert.pem'}. |
middleware |
Array | [] |
feature coming soon |
proxies |
Array | [] |
a list of proxy objects. Each proxy object can be specified by {source: '/abc', target: 'http://localhost:8080/abc', options: {headers: {'ABC_HEADER': 'abc'}}}. |
FAQ
Why can't I reach the server from the network?
Solution: Set 0.0.0.0 as host option.
How can I use html5Mode for my single page app with this plugin?
Solution: Set the index.html of your application as fallback option. For example:
gulp.task('webserver', function() {
gulp.src('app')
.pipe(webserver({
fallback: 'index.html'
}));
});