Home

Welcome to the HopStack wiki. This is where we begin to learn how to develop HopStack. To learn how to use it for your projects, please refer to the user documentation on our website at http://hopstack.io. Keep on crafting!

Cloud Environment Setup and Development

To be a complete badass, build like we build...in the cloud using the finest cloud IDE in the world...Codio.

Create account on Codio and setup your cloud Dev environment: Codio Setup
In your Codio Account preferences, [connect your Github account](ttps://codio.com/s/docs/settings-prefs/account-settings/public-key/ and upload your SSH key to Github. This unlocks your Git option in the Tools menu.
Be sure that the correct Git remotes have been setup correctly. For quick reference:

origin = git@github.com:beardandfedora/hopstack.git

heroku = git@heroku.com:[your_heroku_app_name].git

Run these box part comands to install require Development dependencies:

$ npm install

$ npm update

$ bower install

$ bower update

$ npm install -g grunt-cli

** If Ruby is not installed, use the Tools->Install Software to install Ruby first

$ gem update

$ gem install compass

Codio Notes: The codio setup file (.codio) has pre-built commands specific to this product, found in the run menu in the top bar (second to last menu). It includes quick commands for running tests, adding/committing to git, various grunt tasks, various bower tasks (including managing dependencies), Yeoman tasks, Coffeescript/LESS compiles, git deploys (ie - codio or heroku), etc. At any time, you can add new commands to this menu or the preview menu (last menu in nav), which launches the app in various ways on the local box/environment.
Get to know the Codio cloud IDE, the CLI environment, and how boxes work.
Preview live changes (using the Preview menu options), as configured in .codio config file
Run the Test command from the run menu, as configured in .codio config file
Deploy to the local Codio box using the Grunt Server command to see it running locally at port 3000
Run Grunt Build from the run menu to build the project into ./dist for deployment
Dance a dance of joy!
Deploy

Local Environment Setup and Development

NOTE: NOT NECESSARY WITH CODIO (LOCAL ONLY)

$ git pull origin master
Build, create, test, and code things in the application directory ./client
$ grunt test you wrote tests (because you are a craftsman), and this runs them before building
$ grunt server to launch the built-in node web server, running angular app via LIVERELOAD on port 3000
Verify the app launched - Done, without errors. Browser window will automatically open to localhost:3000
In your terminal, type crtl+C to kill the Running "watch" task seen on the screen
Fix, add, or remove some more code to make it awesome (assumes no errors prevented the build)
$ grunt server to see how awesome it is now at [localhost:3000]http://localhost:3000)
$ git add -all
$ git commit -m "your commit notes"
$ git push origin master
OPTIONAL: For sysadmins, $ git push codio master to deploy to Codio dev
OPTIONAL: For sysadmins, $ git push heroku master to deploy to Heroku stage

Codio Configuration (example)

{ // Configure your Run and Preview buttons here.

// Run button configuration

"commands": {

  `"Test": "grunt test",`
  `"Git Add": "git add --all",`
  `"Git Commit": "git commit -m",`
  `"Grunt": "grunt", `
  `"Grunt Server": "grunt server",`
  `"Grunt LESS": "grunt lessServer",`
  `"Grunt Build": "grunt build",`
  `"Grunt LESS Build": "grunt lessBuild",`
  `"Grunt Heroku: Dev": "grunt heroku:development",`
  `"Grunt Heroku: Prod": "grunt heroku:production",`
  
  `"Node version": "node --version"`

},

// Preview button configuration

"preview": {

  `"Client: index.html": "https://{{domain}}/client/index.html",`
  `"Dist: index.html": "https://{{domain}}//dist/index.html",`
    `"Main (static)": "https://{{domain}}/{{index}}",`
    `"Current File (static)": "https://{{domain}}/{{filepath}}",`
    `"Box URL": "http://{{domain}}:3000/",`
    `"Box URL SSL": "https://{{domain}}:9500/"`

} }