node package manager


alternative interface for vinly-fs


an alternate interface to vinyl-fs

install - examples - why - license

For more information go to the documentation folder.

repl, path-to-regex mapping and async composition

var gulp = require('gulp-runtime').create({repl: true});
var util = require('gulp-runtime/util');
var browserSync = require('browser-sync');
var sass = require('gulp-sass');
var concat = require('gulp-concat');
var webpack = require('gulp-webpack');
var sourcemaps = require('gulp-sourcemaps');
var autoprefixer = require('gulp-autoprefixer');
var opt = require('./config'); // config opts for plugins 
// general purpose watch|unwatch 
var watcher = {};
gulp.task('(watch|unwatch) :glob :tasks((?:\\w+,?)+)', function(next){
  var watch = next.params[0] === 'watch';
  var glob = next.params.glob;
  var tasks = next.params.tasks.split(',');
  if(watch && watcher[glob]){
    util.log('Already watching %s', util.log(glob));
  } else if(watch){
    util.log('Watching %s, tasks after watch \'%s\'',
    watcher[glob] =, tasks);
  } else if(watcher[glob]){
  } else {
    util.log('No watcher set for `%s`', glob);
    util.log('-'+ Object.keys(watcher).join('\n-'));
// all js (even if has some jsx) 
// webpack takes care of sourcemaps and jsx transpiling here 
gulp.task('js', function(){
  return gulp.src('app/**/*.js')
    .once('end', browserSync.reload);
// styles with sourcemaps 
gulp.task('sass', function(){
  return gulp.src('app/styles/*.scss')
    .once('end', browserSync.reload);
// proxy server using browserSync 
function serve(next){
  var server = require('./server');
  var port = server.http._connectionKey.split(':').pop();
  // proxy server with browserSync 
  browserSync({open: false, proxy: 'localhost:'+port});
  // reload browser when html files change'build/*.html', browserSync.reload);
  // reload require.cache for these and reload the browser'server/**/*.js', {reload: true}, browserSync.reload);
// run 
var watching = gulp.stack('watch app/styles/*.scss sass watch app/js/*.js js');
gulp.stack(serve, watching, {wait: true})(/* pass arguments here */);

complete code can be found here

to run it, do just like any other node program

$ node gulpfile.js
[23:31:54] Using ~/code/app-template/gulpfile.js
[23:31:54] Started 'serve watch app/styles/*.scss sass watch app/js/*.js js' in series
[23:31:56] Finished 'serve' after 2.19 s
[23:31:56] Watching app/styles/*.scss, tasks after watch 'sass'
[23:31:56] Finished 'watch app/styles/*.scss sass' after 27 ms
[23:31:56] Watching app/js/*.js, tasks after watch 'js'
[23:31:56] Finished 'watch app/js/*.js js' after 1.44 ms
[23:31:56] Finished 'serve watch app/styles/*.scss sass watch app/js/*.js js' after 2.22 s
[BS] Proxying: http://localhost:8000
[BS] Access URLs:
       Local: http://localhost:3000
          UI: http://localhost:3001
 UI External:


  1. Enter to see the prompt
  2. write the tasks you want to run
  3. or Tab to see completion

for example, the gulp cli is available for every instance. To see all commands available write an hypen and press tab

> - (Press Tab)
--silent        --cwd           --no-color
--color         --tasks-simple  --tasks
-T              --require       --gulpfile

For now you can look at the code at the app-template repo. Do not hesitate to create a new issue with any comments or directly go to gitter and ask there directly. I'll be giving more code examples on the comming weeks.

This started as repl for gulp with a simple interface (completion and cli commands). But it was somewhat limited by how functions were composed at runtime and how you could run a functions previously set. As the project grew I wanted to be able to have more control over task definition and execution. To make this happen:

So now the project puts together this things learnt for vinyl-fs giving an alternate interface for it.

With npm

npm install gulp-runtime