# gulp-serve

> Serve your assets

Latest version **1.4.0** (published 2016-06-30) · MIT license · 0 weekly downloads

## Install

```sh
npm install gulp-serve
pnpm add gulp-serve
yarn add gulp-serve
bun add gulp-serve
```

## 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.4.0 |
| Published | 2016-06-30 |
| First published | 2014-01-24 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 3 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 47 |
| Author | Gusakov Nikita |
| Maintainers | nkt |
| Keywords | gulpfriendly, gulp, serve, connect |

## Links

- npm: https://www.npmjs.com/package/gulp-serve
- Repository: https://github.com/nkt/gulp-serve
- Homepage: https://github.com/nkt/gulp-serve#readme
- Issues: https://github.com/nkt/gulp-serve/issues
- npm.io page: https://npm.io/package/gulp-serve

## Dependencies (3)

- [connect](https://npm.io/package/connect.md) ^3.4.1
- [gulp-util](https://npm.io/package/gulp-util.md) ^3.0.7
- [serve-static](https://npm.io/package/serve-static.md) ^1.11.1

## Recent versions

- 1.4.0 (latest) — 2016-06-30
- 1.3.0 — 2016-06-30
- 1.2.0 — 2015-09-10
- 1.1.0 — 2015-09-10
- 1.0.0 — 2015-05-12
- 0.3.1 — 2015-02-27
- 0.3.0 — 2014-11-02
- 0.2.0 — 2014-03-18
- 0.1.1 — 2014-02-02
- 0.1.0 — 2014-01-26
- 0.0.1 — 2014-01-24

## README

gulp-serve
==========
[![Circle CI](https://circleci.com/gh/nkt/gulp-serve/tree/master.svg?style=svg)](https://circleci.com/gh/nkt/gulp-serve/tree/master)
[![Downloads](https://img.shields.io/npm/dm/gulp-serve.svg)](https://www.npmjs.com/package/gulp-serve)

Provide connect-server functionality, using [connect.static](http://www.senchalabs.org/connect/static.html)

Install
=======
Install with [npm](https://npmjs.org/)

    npm i --save-dev gulp-serve

Usage
=====

```js
var gulp = require('gulp');
var serve = require('gulp-serve');

gulp.task('serve', serve('public'));
gulp.task('serve-build', serve(['public', 'build']));
gulp.task('serve-prod', serve({
  root: ['public', 'build'],
  port: 80,
  middleware: function(req, res) {
    // custom optional middleware
  }
}));
```

With HTTPS enabled (using built-in key and certificate for `localhost`):
```js
var gulp = require('gulp');
var serve = require('gulp-serve');

gulp.task('serve', serve('public'));
gulp.task('serve-build', serve(['public', 'build']));
gulp.task('serve-prod', serve({
  root: ['public', 'build'],
  port: 443,
  https: true,
  middleware: function(req, res) {
    // custom optional middleware
  }
}));
```

With HTTPS enabled (using self provided key and certificate):
```js
var gulp = require('gulp');
var serve = require('gulp-serve');

gulp.task('serve', serve('public'));
gulp.task('serve-build', serve(['public', 'build']));
gulp.task('serve-prod', serve({
  root: ['public', 'build'],
  port: 443,
  https: {
    key: 'path/to/cert.key',
    cert: 'path/to/cert.pem'
  },
  middleware: function(req, res) {
    // custom optional middleware
  }
}));
```

License
=====

[![MIT](https://img.shields.io/npm/l/express.svg)](LICENSE)

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