minify-css-map

library0.0.6jsnpmunverified

A Node.js package (v0.0.6) that minifies CSS files by removing whitespace and comments, and generates source maps automatically. It recursively processes directories, producing .min.css and .css.map files. No configuration is needed. Unlike full-featured build tools, it is a lightweight, zero-dependency utility for simple CSS minification with source map support. The release cadence is low (version 0.0.6), and it requires Node 20.x.

devops

npm install minify-css-map

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · MINIFY-CSS-MAP

minify-css-map

devopsjavascriptv0.0.6

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

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

minifyCssFile

✓ import { minifyCssFile } from 'minify-css-map'

✗ const minifyCssFile = require('minify-css-map').minifyCssFile

This package is ESM-only and does not support CommonJS require().

Shows programmatic usage: importing minifyCssFile, calling it with a file path, and writing the output CSS and source map files.

import { minifyCssFile } from 'minify-css-map'; import { writeFileSync, readFileSync } from 'fs'; import { join } from 'path'; const inputPath = join(process.cwd(), 'styles.css'); const outputCssPath = join(process.cwd(), 'styles.min.css'); const outputMapPath = join(process.cwd(), 'styles.css.map'); async function run() { const result = await minifyCssFile(inputPath); // result is { css: string, map: object } writeFileSync(outputCssPath, result.css, 'utf-8'); writeFileSync(outputMapPath, JSON.stringify(result.map), 'utf-8'); console.log('Minified CSS and source map generated successfully.'); } run().catch(err => console.error(err));

Debug

Known issues

gotchaPackage is ESM-only; require() will fail with a runtime error.

fix

Use import statements. If using CommonJS, use dynamic import(): const { minifyCssFile } = await import('minify-css-map');

affects: >=0.0.0

gotchaThe minifyCssFile function expects an absolute file path, not a relative path.

fix

Use path.resolve() or join() to create an absolute path before passing to minifyCssFile.

affects: >=0.0.0

gotchaNode.js version requirement: Node 20.x is specified; using older versions may cause unexpected errors.

fix

Ensure you are using Node.js version 20 or higher.

affects: >=0.0.0

deprecatedThe CLI command 'npx minify-css-map' is experimental and may change in future versions.

fix

Prefer using the JavaScript API for stability.

affects: <=0.0.6

Errors

Common errors & fixes

TypeError: minifyCssFile is not a function

CommonJS require() imports the module incorrectly (ESM-only package).

fix

Use import { minifyCssFile } from 'minify-css-map'; or dynamic import.

Error: ENOENT: no such file or directory, open '...'

Relative path passed to minifyCssFile; it expects an absolute path.

fix

Convert to absolute path using path.resolve() before calling minifyCssFile.

SyntaxError: Unexpected token 'export'

Attempting to require() an ESM module in a CommonJS context.

fix

Ensure your project is configured for ESM (type: module in package.json) or use dynamic import.

Upgrade

Version history

0.0.6latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/npm-packages-collection/minify-css-map ↗

packageminify-css-map ↗

homepagehttps://github.com/npm-packages-collection/minify-css-map#readme ↗