bocoup / roost-chicago-2014-app

Roostagram!

Roostagram!

Roostagram was created by engineers at Bocoup to demonstrate and teach the software development process using modern tools and workflows. This application is collaboratively built during Roost and Bocoup's training classes.

We want everyone to learn from this repository, though!

• Code comments document how the application works. These comments are distributed throughout the source code.
• The project's git history describes why the code is written the way it is. We've meticulously crafted the history to demonstrate an ideal application development process. If you need help reading the git history, check out these screencasts on bocoup.com:
  • Navigating git using the CLI
  • Navigating git using GitHub.com

Installation

Make sure you have all this stuff:

1. Install nodejs. Make sure you install something on the v.0.10 release branch. Version 0.11 is a development branch and breaks some of the libraries in our application.
2. Install Grunt globally by typing npm install -g grunt-cli into your terminal/command line.
3. Install Bower globally by typing npm install -g bower.
4. Install git.
5. Install the Java Development Kit

Once you have all of these, you can download this repo, cd into this directory, run npm install to install all of the dependencies, and grunt to start the tasks to run the server and see the site.

Troubleshooting

If npm shows errors (which can happen from time to time due to network issues) re-try the command. If npm needs administrator access, Mac and Linux users should run with the sudo command; Windows users should run their command shell as the Administrator.

Further Reading

The docs/ directory contains additional documentation related to the project.

• tools.md: a partial listing of the tools used to make Roostagram
• resources.md: educational materials covering some of the core concepts for Roostagram

License

Copyright (c) 2014 Bocoup
Licensed under the MIT Expat license.

roost-chicago-2014-app's Issues

Issues installing and running site

I attended the Chicago Roost conference, and I was able to run Roostagram locally at that point. However, I'm not able to run it now on a different computer. I'm running through the installation steps, but I'm hitting the following errors (I'm on a Windows machine):

When running npm install:
configure error
stack Error: Can't find Python executable "python", you can set the PYTHON env variable.
stack at failNoPython (C:\Program Files\nodejs\node_modules\npm\node_modules\node-gyp\lib\configure.js:118:14)
stack at C:\Program Files\nodejs\node_modules\npm\node_modules\node-gyp\lib\configure.js:81:11
stack at Object.oncomplete (fs.js:107:15) System Windows_NT 6.1.7601
command "node" "C:\Program Files\nodejs\node_modules\npm\node_modules\node-gyp\bin\node-gyp.js" "rebuild"
cwd D:\Roostagram\node_modules\webdriver-sync\node_modules\java
node -v v0.10.18
node-gyp -v v0.10.9
not ok

When running grunt:
Warning: PhantomJS timed out, possibly due to a missing Mocha run() call. Use --
force to continue.

Aborted due to warnings.