# gulp-customize-bootstrap

> A gulp plugin that overrides Bootstrap's core Sass or Less files without modifying Bootstrap

Latest version **0.0.6** (published 2016-05-16) · MIT license · 0 weekly downloads

## Install

```sh
npm install gulp-customize-bootstrap
pnpm add gulp-customize-bootstrap
yarn add gulp-customize-bootstrap
bun add gulp-customize-bootstrap
```

## Health

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

Positive: no vulnerabilities.

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

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.0.6 |
| Published | 2016-05-16 |
| First published | 2016-05-14 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 3 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 7 |
| Author | Derek Rushforth |
| Maintainers | diraq |
| Keywords | gulpplugin, bootstrap, bootstrap 3, bootstrap 4, sass, less |

## Links

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

## Dependencies (3)

- [lodash](https://npm.io/package/lodash.md) ^4.12.0
- [fs-finder](https://npm.io/package/fs-finder.md) ^1.8.1
- [gulp-util](https://npm.io/package/gulp-util.md) ^3.0.7

## Alternatives

- [@sveltejs/kit](https://npm.io/package/@sveltejs/kit.md) — 2.2M weekly downloads
- [@atlaskit/theme](https://npm.io/package/@atlaskit/theme.md) — 402.0K weekly downloads
- [@tangle-network/brand](https://npm.io/package/@tangle-network/brand.md) — 10.0K weekly downloads
- [seneca](https://npm.io/package/seneca.md) — 7.4K weekly downloads
- [@bsb/base](https://npm.io/package/@bsb/base.md) — 7.2K weekly downloads

## Recent versions

- 0.0.6 (latest) — 2016-05-16
- 0.0.5 — 2016-05-15
- 0.0.4 — 2016-05-15
- 0.0.3 — 2016-05-15
- 0.0.2 — 2016-05-15
- 0.0.1 — 2016-05-14

## README

# gulp-customize-bootstrap [![Build Status](https://travis-ci.org/wildbit/gulp-customize-bootstrap.svg?branch=master)](https://travis-ci.org/wildbit/gulp-customize-bootstrap)

A gulp plugin that overrides Bootstrap’s core Less or Sass files without modifying Bootstrap. This is a modified and extended version of [grunt-customize-bootstrap](https://github.com/ianwremmel/grunt-customize-bootstrap).

See our examples for [Bootstrap 3](https://github.com/wildbit/gulp-customize-bootstrap/tree/master/examples/bootstrap-3) and [Bootstrap 4](https://github.com/wildbit/gulp-customize-bootstrap/tree/master/examples/bootstrap-4).

## Install
```
npm install --save-dev gulp-customize-bootstrap
```

## Usage
This plugin works using Bootstrap’s npm, bower, or static file installs. Just make sure you pass in the correct Bootstrap less or sass file using `gulp.src`.


### Bootstrap 3 using Less

```js
var customizeBootstrap = require('gulp-customize-bootstrap');
var less = require('gulp-less');

gulp.task('compileBootstrap', function() {
  return gulp.src('node_modules/bootstrap/less/bootstrap.less')
    .pipe(customizeBootstrap('styles/less/*.less'))
    .pipe(less())
    .pipe(gulp.dest('styles/'));
});
```


### Bootstrap 4 using Sass

Make sure that Bootstrap 4 is installed.


npm – `npm install bootstrap@4.0.0-alpha.2`

Bower – `bower install bootstrap#v4.0.0-alpha.2`


```js
var customizeBootstrap = require('gulp-customize-bootstrap');
var sass = require('gulp-sass');

gulp.task('compileBootstrap', function() {
  return gulp.src('node_modules/bootstrap/scss/bootstrap.scss')
    .pipe(customizeBootstrap('styles/scss/*.scss'))
    .pipe(sass())
    .pipe(gulp.dest('styles/'));
});
```

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