scss-bundle
Bundles all SCSS imports into a single file recursively.
scss-bundle
Who uses Projects
Community plugins
Get started
If you want to use scss-bundle
globally
$ npm install scss-bundle -g
Latest dev build is published under canary
tag.
$ npm install scss-bundle@canary
To start using the tool, create a config file and run command:
$ scss-bundle
It will bundle all scss files in specified outFile
location.
CLI Usage
$ scss-bundle -h
Configuration
Config file properties can be overridden with CLI flags.
CLI Flag | Bundler options | Type | Description | Values | Default |
---|---|---|---|---|---|
-c, --config <path> | string | Configuration file location. | |||
-p, --project <path> | project | string | Project location where node_modules is located. |
||
-e, --entryFile <path> * |
entryFile * |
string | Bundle entry file location. | ||
-o, --outFile <path> * |
outFile * |
string | Bundle output location. | ||
--rootDir <path> | rootDir | string | Specifies the root directory of input files. | ||
-w, --watch [boolean] | watch | boolean | Watch files for changes. Works with rootDir . |
||
--ignoreImports <list> | ignoreImports | string[] | Ignore resolving import content by matching a regular expression. | ||
--includePaths <list> | includePaths | string[] | Include paths for resolving imports. | ||
--dedupeGlobs <list> | dedupeGlobs | string[] | Files that will be emitted in a bundle once. | ||
--logLevel <level> | logLevel | string | Console log level. | silent, error, warning, info, debug, trace | info |
*
- Required
Example config
Default name for configuration is scss-bundle.config.json
.
Non-CLI usage
Simple example
;; ;
API
Bundler
;
Constructor
constructorfileRegistry: FileRegistry = , projectDirectory?: string
Arguments
fileRegistry?:
Registry - Dictionary of files contents by full pathprojectDirectory?: string
- Absolute project location, wherenode_modules
are located. Used for resolving tilde imports
Methods
bundle
public async bundlefile: string, fileRegistry: Registry = : Promise<BundleResult>
Arguments
file: string
- Main file full pathfileRegistry:
Registry - Dictionary of files contents by full path
Returns
Promise<
BundleResult>
Contracts
BundleResult
;
Properties
imports:
BundleResult[]
- File imports arraytilde?: boolean
- Used tilde importfilePath: string
- Full file pathcontent: string
- File contentfound: boolean
- Is file found
Registry
;
Key
id: string
- File full path as dictionary id
Value
string | undefined
- File content
License
Released under the MIT license.