Normandy-css NPM

Normandy CSS

Normandy is a CSS boilerplate that gives you an initial structure for your CSS.

It's build upon ITCSS, BEM and OOCSS. Normandy is a customized version of inuitcss.

Documentation

To check out our Getting Started and References documentation, visit our Github Pages.

Installation

You can install Normandy from npm:

npm install --save-dev normandy-css

Since Normandy is using Sass, you will need to add its core files to your own main.scss.

We recommend a structure as follows, where you zip Normandy layers with your own:

@import "/node_modules/normandy-css/scss/1-Settings/main";
@import "/my/path/to/scss/1-Settings/main";

@import "/node_modules/normandy-css/scss/2-Tools/main";
@import "/my/path/to/scss/2-Tools/main";

@import "/node_modules/normandy-css/scss/3-Generic/main";
@import "/my/path/to/scss/3-Generic/main";

@import "/node_modules/normandy-css/scss/4-Base/main";
@import "/my/path/to/scss/4-Base/main";

@import "/node_modules/normandy-css/scss/5-Objects/main";
@import "/my/path/to/scss/5-Objects/main";

@import "/node_modules/normandy-css/scss/6-Components/main";
@import "/my/path/to/scss/6-Components/main";

@import "/node_modules/normandy-css/scss/7-Utilities/main";
@import "/my/path/to/scss/7-Utilities/main";

This way, you maintain the desired layer structure while allowing your values to override Normandy's.

FAQs

"I want to play with Normandy!"

Great! There's an output.css file in the root directory of the project with the compiled version of the default values. Feel free to grab this file and add it to any Codepen, Fiddle or Codesandbox.

Bear in mind that you won't be able to benefit from Sass variables (obvs) and other goodies.

Also, please notice that Normandy isn't intended to be used this way. You should customize its Settings to match your design guidelines.