gulp-component

Component build plugin for Gulp

gulp-component

Component builder plugin for gulp

Example usage using a Stylus build plugin and watching script and style changes separately:

var gulp      = require('gulp'),
    component = require('gulp-component'),
    stylus    = require('component-stylus-plugin')
 
gulp.task('scripts', function () {
    gulp.src('component.json')
        .pipe(component.scripts({
            standalone: true
        }))
        .pipe(gulp.dest('build/js'))
})
 
gulp.task('styles', function () {
    gulp.src('component.json')
        .pipe(component.styles({
            configurefunction (builder) {
                builder.use(stylus)
            }
        }))
        .pipe(gulp.dest('build/css'))
})
 
gulp.task('watch', function () {
    gulp.watch(['component.json', 'src/**/*.js'], ['scripts'])
    gulp.watch(['component.json', 'src/**/*.styl'], ['styles'])
})
 
gulp.task('default', ['scripts', 'styles'])
  • Type: String
    Default: 'build'

    The filename for built files.

  • Type: String or Array
    Default: undefined

    Build only certain types of assets. Available asset types are: 'scripts', 'styles', 'images', 'fonts', 'files', 'templates', 'json'. Each of these types has an alias to create a stream that builds that type only, e.g. component.scripts([options])

  • Type: Function
    Default: undefined

    A function to add custom configurations to the builder.

  • Type: Boolean or String
    Default: false

    Wrap the built js code with a UMD wrapper. If it's a string, it will be used to expose the component on the this context.

  • Type: String
    Default: 'build'

    The directory to link/copy assets (images, fonts and files) to.

  • Type: Boolean
    Default: false

    Copy assets instead of linking.

  • Type: Array
    Default: undefined

    An array of plugins/functions to be used by the builder.

  • Type: Array
    Default: undefined

    An array of component dependencies to ignore.

  • Type: Boolean
    Default: false

    Include dev dependencies and add source urls.

  • Type: String
    Default: undefined

    Prefix css asset urls.

  • Type: Boolean
    Default: false

    Exclude require from build. Ignored when options.standalone is truthy.

MIT