scss-compile

0.1.7 verified Fri May 01 auth: no javascript deprecated

A minimal npm package that provides a CLI wrapper around node-sass for compiling SCSS to CSS. Version 0.1.7, last published in 2016. It is essentially a thin script that runs 'node-sass -rw' with hardcoded default paths (assets/scss -> assets/css). There is no active development or maintenance; it is functionally equivalent to using node-sass directly. Not recommended for new projects; prefer 'sass' (Dart Sass) or node-sass directly.

Common errors

error Error: Cannot find module 'node-sass' ↓

cause node-sass is not installed. scss-compile depends on node-sass but does not install it automatically.

fix

npm install node-sass in the same project or globally.

error sh: scss-compile: command not found ↓

cause scss-compile is not installed or not in PATH.

fix

Install globally: npm install -g scss-compile, or use npx scss-compile.

error Error: ENOENT: no such file or directory, stat 'assets/scss' ↓

cause The default input directory (assets/scss) does not exist.

fix

Create the directory: mkdir -p assets/scss, or edit package.json to point to your SCSS source directory.

Warnings

deprecated scss-compile has not been updated since 2016 and depends on the deprecated node-sass package, which is now replaced by Dart Sass (the official 'sass' package). ↓

fix Use 'sass' package directly: npm install -g sass && sass --watch assets/scss:assets/css

gotcha The scss-compile binary uses Node.js v4+ features and may fail on newer Node versions due to node-sass native module incompatibility. ↓

fix Use the 'sass' package (Dart Sass) which is pure JavaScript and compatible with Node 14+.

breaking scss-compile always runs in watch mode (-w flag) and loops indefinitely. It does not support one-off compilation without editing the script. ↓

fix Use node-sass directly for one-off builds: node-sass assets/scss/style.scss assets/css/style.css

Install

npm install scss-compile

yarn add scss-compile

pnpm add scss-compile

Imports

no default export
wrong
```
import scssCompile from 'scss-compile'
```
correct
```
npx scss-compile
```
scss-compile is a CLI tool, not a JavaScript library. There is no programmatic API; it is intended to be used via npm scripts or npx.
package.json script entry
wrong
```
"scripts": { "scss": "node-sass -rw src -o dist" }
```
correct
```
"scripts": { "scss-compile": "scss-compile" }
```
The package registers a binary 'scss-compile' which is invoked via npm run. No require or import is possible.
global installation
wrong
```
npm install scss-compile --save
```
correct
```
npm install -g scss-compile && scss-compile
```
Works best as a global install or via npx. Saving as a project dependency and running npx scss-compile is also valid.

Quickstart

Installs scss-compile and node-sass globally, creates a sample SCSS file, and runs the compiler in watch mode to output CSS to assets/css.

npm install -g node-sass scss-compile
mkdir -p assets/scss
echo '$primary: #333; body { color: $primary; }' > assets/scss/style.scss
scss-compile
# Note: this runs node-sass -rw assets/scss -o assets/css indefinitely (watch mode). Press Ctrl+C to stop.