Registry / node-bourbon

node-bourbon

JSON →
library4.2.8jsnpmunverified

Node Bourbon is a `node-sass` wrapper for the now-unmaintained Bourbon Sass library. It provided a convenient way for Node.js developers to integrate Bourbon's Sass mixins and functions into their projects using `node-sass` (which itself is a binding for LibSass). The package reached its last stable version, 4.2.8, in March 2016. Since then, both `node-bourbon` and the original Bourbon project by thoughtbot have been abandoned. The original Bourbon library recommends transitioning to native CSS. Consequently, `node-bourbon` is not compatible with modern Sass compilers like Dart Sass or recent versions of Node.js, making it unsuitable for new projects and difficult to maintain in existing ones.

Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
node 18226 runs
build_error
glibc
node 18226 runs
build_error
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

This package is CommonJS-only and does not support ES modules.

const bourbon = require('node-bourbon');

Accesses the array of Bourbon's Sass include paths directly.

require('node-bourbon').includePaths

The `with()` function must be called to return the augmented array of paths.

require('node-bourbon').with('path/to/extra/scss')

Demonstrates basic integration of `node-bourbon` with a Gulp build process using `gulp-sass` for compiling Sass files, including Bourbon's mixins.

const gulp = require('gulp'); const sass = require('gulp-sass')(require('sass')); // Using 'sass' for modern compatibility, though node-bourbon expected node-sass const path = require('path'); gulp.task('sass-compile', function () { return gulp.src('src/styles/*.scss') .pipe(sass({ // The primary way to include Bourbon paths is via includePaths includePaths: require('node-bourbon').includePaths // Alternatively, to include additional directories alongside Bourbon's: // includePaths: require('node-bourbon').with(path.join(__dirname, 'src/components')) }).on('error', sass.logError)) .pipe(gulp.dest('dist/css')); }); // To run this, ensure you have gulp, gulp-sass, sass (Dart Sass) and node-bourbon installed. // You'll also need a 'src/styles/main.scss' file, e.g.: // // /* src/styles/main.scss */ // @import "bourbon"; // // body { // @include display(flex); // background-color: #f0f0f0; // } // // Run with: `npx gulp sass-compile`
Debug
Known footguns
breakingThe `node-bourbon` package is effectively abandoned, with its last release over 10 years ago. It is built to wrap an older, also unmaintained version of the Bourbon Sass library (v4.x). Modern Sass environments (Dart Sass) and newer Node.js versions are not officially supported.
breakingThis package exclusively relies on `node-sass` (LibSass), which itself is deprecated and no longer actively developed. It will not work with the modern `sass` package (Dart Sass) without careful configuration or potential breakage.
gotchaEarlier versions and even 4.2.7/4.2.8 had issues with returning incorrect or nested Bourbon paths, potentially leading to 'file not found' errors during Sass compilation.
gotcha`node-bourbon` is explicitly NOT tested against the Ruby version of Sass. Using it with `grunt-contrib-sass` (which typically invokes Ruby Sass) may lead to unexpected behavior or compilation failures.
Upgrade
Version history

Breaking-change detection hasn't run for this library yet.

Audit
Security & dependencies

CVE tracking and dependency tree are planned for a later release.

Agent activity
6 hits · last 30 days
ahrefsbot
4
script
1
googlebot
1
Resources