Logo by @aemino
diamond supports node 4, 5, 6, and 7 with npm 3 or 4 (Note: node 4 comes with npm 2)
Let's be upfront, we collect data. You will soon be able to limit the data we collect. All data is anonymous. This data is not shared with anyone outside of the diamond team.
diamond is a package manager for Sass and Less. diamond allows you to mix and match (most of the time) Sass and Less packages. You can also ship custom functions to be run after compiling, or even Less plugins and Sass importers and functions.
npm i -g diamondpkg
Or install the latest version from GitHub:
npm i -g diamondpkg/diamond
Lets say you want to use Bootstrap in your next project.
You can find Bootstrap under the package name
You install with the
diamond install bootstrap
This generates a
diamond folder with all of the packages.
Do not edit any files in this folder.
diamond uses a custom import format when importing packages.
@import "~bootstrap";will import the main file from Bootstrap, or throw an error if the package does not have a main file.
@import "~bootstrap/file.scss"will import
file.scssfrom the package Bootstrap.
We want to import Bootstrap's main file, so we will use
To use with vanilla CSS or another preprocessor, simply link the
diamond/autoload.css file in your HTML. Compiling is not required with CSS.
Once we have written our sass, we are ready for compiling.
If you try
it will give you errors about not being able to find the file
This is because you aren't using diamond's custom importer.
It is recommended to use the compile command to compile your Sass instead of node-sass.
While this is not required, some packages like
concise.css use functionality only found
in the compile command. You will be warned if you are missing out on features not using
the compile command.
diamond compile -o output.css input.scss
To compile with node-sass, use the
node-sass --importer diamond input.scss > output.css
diamond is the generated
diamond folder on install.
To compile with Less, either use the compile command, or lessc. (They both have the same features)
diamond compile -o output.css input.less
lessc --diamond input.less output.css
less-plugin-diamond as a plugin, which is installed when you install diamond.