Ambition Generator
Yeoman generator for Ambition.
Table of Contents
Installation
To install Yeoman:
npm install -g yoTo install the Ambition generator:
npm install -g generator-ambitionUsage
Using the Ambition generator is simple:
yo ambitionTo run tests:
npm testTo build your project (compiles js and/or css to the build directory):
npm run buildOptions
The Ambition generator will ask you several questions and generate app scaffolding based on your answers.
What would you like to call your project? (required)
The name of your project. Used to create folder and file names.
Does your project use Stylus?
True to include Stylus for automatic compilation. Save your .styl files to the style directory. The resulting css is saved to build/project-name.css.
Does your project use jQuery?
True to include jQuery in the project. The jQuery files are saved to lib/jquery.
Does your project used ECMAScript 6?
True to include the Traceur compiler and runtime. The runtime files are saved to lib/traceur.
Do you want to run tests on Browserstack?
True to automatically run your Jasmine tests on Browserstack. You must set appropriate BROWSERSTACK_USERNAME and BROWSERSTACK_KEY enviornment variables before testing. This task is ignored if both variables are not set.
Do you want to exlcude JavaScript from your project?
True to exclude JS compilation and testing tools from your project.
Structure
Save .styl files to the style directory. Save .js files to appropriate modules in the src directory. Save tests in each module's tests directory.
Example file tree (with included CSS and jQuery):
.├── bower.json├── build│ ├── my-app.js│ └── my-app.css├── gruntfile.js├── lib│ └── jquery│ ├── MIT-LICENSE.txt│ ├── bower.json│ ├── jquery.js│ ├── jquery.min.js│ └── jquery.min.map├── package.json├── src│ └── my-app│ ├── app.js│ └── tests│ └── app_tests.js└── style └── variables └── all.styl