Skip to content

Latest commit

 

History

History
212 lines (148 loc) · 7.85 KB

README.md

File metadata and controls

212 lines (148 loc) · 7.85 KB
Raw

generator-columbia-angular

Yeoman generator that scaffolds out a full stack Javascript web app using angularjs, Grunt and Bower, Node and Express, MongoDB and Redis.

Getting Started

Using this generator:

Pre-reqs:

This generator uses Sass with Compass for preprocessing stylesheets. In order to make use of this feature, you need to have ruby, sass and compass installed. I personally use rbenv for managing ruby. I also use nvm for managing node:

brew install rbenv brew install rbenv-gem-rehash

  1. Install MongoDB
  2. Install ruby
  3. Install Sass and Compass
  4. Install hub: $ brew install hub or for windows you may have to install hub from source: https://github.com/github/hub. For Windows users, you may also be able to install it through Chcolatey using this project
  5. While we're at it, let's just install a bunch of useful gems:
gem install sass
gem install compass
# you may have to install compass with the --pre flag and compass-rails
gem install compass --pre
gem install compass-rails
gem install bundler foreman pg rails thin --no-rdoc --no-ri
gem install redcarpet pygments.rb

You also need to have grunt-cli and blower installed globally. Here are my current global npm installs:

If you're not familiar with Yeoman and want to learn more If you want to build your own generator

Finally, make sure you don't need sudo privileges to run either gem install or npm install:

http://www.wenincode.com/installing-node-jsnpm-without-sudo/

http://www.johnpapa.net/how-to-use-npm-global-without-sudo-on-osx/

For gems, use rbenv

Install Yeoman:

$ npm install -g yo

To install generator-columbia-angular from npm, run:

$ npm install -g generator-columbia-angular

Finally, initiate the generator:

$ yo columbia-angular optionalAppName

Before you actually can run the app, you need to make sure that mongodb is running. In a separate terminal run $ sudo mongod, then run $ grunt.

Recommended github and heroku setup:

run $ yo columbia-angular:deploy to setup both github and heroku automatically.

Note: If your version of git is out of date, heroku may refuse to create your app for the reasons specified at https://blog.heroku.com/archives/2014/12/24/update_your_git_clients_on_windows_and_os_x and you may have to first update git. If you choose to do this with homebrew, which I recommend (for making upgrading in the future easier), you may have to set your path to use /usr/local/bin/ before using /usr/bin/ (the default). You can do this by running:

$ brew sh

and should get the following message:

Your shell has been configured to use Homebrew's build environment:
this should help you build stuff. Notably though, the system versions of
gem and pip will ignore our configuration and insist on using the
environment they were built under (mostly). Sadly, scons will also
ignore our configuration.
When done, type `exit'.
brew \[\033[1;32m\]\w\[\033[0m\]$

Then restart your terminal. If that doesn't fix your issue, refer to this homebrew issue thread for additional workarounds:

The command uses the following to setup Github:

$ hub init
$ hub add . && hub commit -m "initial commit"
$ hub create optional_org_name/repo_name -d "description of repo"
$ hub push origin master

And to setup Heroku, it runs grunt build, copies over the Procfile, initializes the dist/ dir as a separate repository, and runs:

$ heroku apps:create herokuAppName && heroku config:set NODE_ENV=production
$ git add -A && git commit -m "Initial commit"
$ git push heroku master

all of which you can of course do at the command line, provided you have both hub and the heroku toolbelt installed.

More info on working with node in Heroku

The deploy generator also uses a plugin called heroku-config to push your local .env file to heroku. Install it with:

$ heroku plugins:install git://github.com/ddollar/heroku-config.git

Deployment requires that you have a remote mongo database to connect to. You can use heroku addons to create one:

 heroku addons:add mongolab

or you can [setup a mongolab account] and create one online. If you do this, just make sure to set the MONGOLAB_URI on heroku to the URI for accessing that db.

Versioning and releases

This project uses semantic versioning and github for releases. Releases can be created automatically using the grunt bump task, which will create a conventional changelog as well as a release. For more, see:

grunt-release github on creating releases grunt-conventional-changelog commit conventions node-semver

To create new releases with changelogs using the autorelease as it currently stands:

  1. $ grunt bump:releaseType
  2. $ grunt autorelease:releaseType

Release type should be one of patch, minor, major, or prerelease

running grunt bump simply bumps the version, which enables conventional changelog to use the correct latest version when generating its changelog. grunt autorelease then does the following:

  1. runs the "changelog" task
  • Generates changelog from previous version to HEAD...
  • Parses commits since last version
  • updates CHANGELOG.md updated
  1. runs the "addchangelog" task:
  • stages CHANGELOG.md
  • committs CHANGELOG.md
  1. runs the "release:patch" (release) task:
  • stages package.json
  • commits package.json
  • creates new git tag: v0.2.8
  • pushes to remote git repo
  • pushes new tag 0.2.8 to remote git repo

To then test the production version: $ grunt build $ grunt serve:prod

To then commit and push the production version to heroku: $ cd dist $ git status $ git add --all

And normally we include a message like: $ git commit -m "feat(v0.2.3): dist build for v0.2.3" $ git push heroku master

Inspirations:

Publishing to npm

Go to https://www.npmjs.com/ and click on "create account". You must have an account on npm in order to publish modules

Before publishing

  1. Test the version locally by: a. linking the module to npm by running $ npm link inside the repo root b. linking to the linked module by running $ npm link <module-name> from inside the directory you wish to use it in.
  2. Once you're ready to publish, run $ npm unlink inside repo root and $npm unlink <module-name> inside test dir so you don't still have the local version linked in.
  3. if this is the first time publishing run $ npm publish.
  4. Otherwise, you must bump the version before running this command. This should be done using the grunt bump and grunt autorelease commands specified above (eventually this should also publish to npm automatically).