generator-famous
![Dependency Status](https://camo.githubusercontent.com/0b23d083e8ef45e171fe8e46bd4ab58bdbf49c2bd4555b685fb7e822fe79c994/68747470733a2f2f64617669642d646d2e6f72672f46616d6f75732f67656e657261746f722d66616d6f75732e737667)
Use this yeoman generator to seed your next Famo.us project... automation ftw!
Trick question. It's not a thing. It's this guy:
Basically, he wears a top hat, lives in your computer, and waits for you to tell him what kind of application you wish to create.
Not every new computer comes with a Yeoman pre-installed. He lives in the npm package repository. You only have to ask for him once, then he packs up and moves into your hard drive. Make sure you clean up, he likes new and shiny things.
$ npm install -g yo grunt-cli bower
To install generator-famous
from npm simply run the command
$ npm install -g generator-famous
Make a directory to put your app into and hop in
$ mkdir famousApp # mkdir makes a new directory
$ cd famousApp # cd is short for change directory
$ yo famous # Let's call the yeoman to make us famous
- Development server with live-reload
- Real time linting with eslint and jscs
- Automatically inject bower-installed vendor code into require.js config
- All the dot files!
- A single command to prepare your project for production
Available generators:
- famous (a.k.a. famous:app)
- famous:view
These generators must be run from the root directory of you project
###App
Description: Creates a default Famo.us app
Example:
yo famous
This will create:
README.md
Gruntfile.js
bower.json
package.json
.bowerrc
.editorconfig
.edlint.json
.jscs.json
app/index.html
app/src/main.js
app/src/requireConfig.js
app/src/content/images/famous_symbol_transparent.png
app/src/styles/app.css
###View
Description: Creates a new View
Example:
yo famous:view MyView
This will create:
app/src/views/MyView.js
yo famous:view Some/Path/OtherView
This will create:
app/src/views/Some/Path/OtherView.js
If you'd like to get to know Yeoman better and meet some of his friends, Grunt and Bower, check out the complete Getting Started Guide.
###Be Aware of .yo-rc.json
When this generator scaffolds out a project it generates a .yo-rc.json file. This file allows yo to run again in the same directory without prompting you for information. This is particularly useful if you want to update your project to be based on the latest version of generator-famous. This can be a problem though, as yo searches up the file tree to check if there is a version of .yo-rc.json. So if you for example accidentally ran yo famous
from a directory that was not empty, you might end up leaving the .yo-rc.json in the directory above where you would like to be. The result will be then when running yo in an empty directory afterwards your files will never end up in the folder you are expecting them to.
PHEW
TLDR: If yo famous
is putting things in parent directories check for an orphaned .yo-rc.json
This generator could not have been made possible without the great work done on generator-webapp, generator-angular, and generator-assemble
MPL V2.0