generator-brei-app

generator-brei-app

Getting Started

Install Yeoman

npm install -g yo

Install Ruby

Install Compass, SASS, and SCSS_Lint

sudo gem install compass sass scss_lint

Install the BREI-App Generator

npm install -g generator-brei-app

Finally, initiate the generator:

yo brei-app

From here you will be presented with a series of options:

What would you like to do? (Use arrow keys)
❯ Create a New Project
  Create a Partial
  Create a Module
  Create a Template
  Import a Pattern
  Update Your Project

Just follow the promps and off you go!

Sub-Generators

All Sub-Generators install the properly formatted .hbs and .scss file. All according to conventions. Woot.

Note: you can either run yo brei-app and select the desired sub generator task, or you can use the following commands to do it manually.

Create a new Project:

yo brei-app:new

Create a new Template:

yo brei-app:template

#  @param {String} the name of your template

Create a new Module

yo brei-app:module

#  @param {String} the name of your module

Create a new Partial

yo brei-app:partial

#  @param {String} the name of your partial

Add a pattern from the BREI Pattern Library

yo brei-app:pattern

#  @param {String} The type of pattern (template, module, partial)
#  @param {String} The name of the pattern (the pattern must exists)

• You will be provided a list of available patterns, so long as the library's pattern.json is up to date. This will help prevent issues of spelling the name wrong.

Update part of your project

yo brei-app:update

• This will provide you with options on which segment of the project you would like to update.
• Tips: when a conflict occurs, hit "d" to see a diff of changes, hit "y" to overwrite, hit "n" to not overwrite.

Testing

This generator has git pre-commit hook that will forcefully run the tests and jshint whenever you seek to make a commit

Prerequisites:

npm install -g jshint

To Test:

npm test