#OpenGameArt README

##Things used

• node.js Backend Server
• express.js Backend Server
• bootstrap Frontend structure
• jqueryui Frontend JS
• npm Installer
• Heroku Live tests
• Postgresql Backend Database
• Ejs Backend view engine
• gm Image manipulation
• imagemagick gm is based of this.
• fs Middleware File system
• toobusy Middleware Backend load failure handler;
• connect-cachify Middleware caching and concatenating
• client-sessions
• bcrypt

##Security Why bcrypt? Here and more and a Paper by provos

##Toobusy This lets us timeout a client connection if we can't handle it at. This is better then letting the client hang.

##Connect-cachify This makes 'for production' js min files and css files(concatenating). It also caches them for faster access.

##client-sessions Why use this? This stores session info on the client browser instead server-side. Faster + scalablity. Downside is trusting the client not to edit the sessions but this library is secure and tamper-free!

##gm Image stuff. Useful for image effects and indirectly useful for thumbnailing things.

##Installation Make a folder somewhere called opengameart.

mkdir opengameart

Then open the folder.

cd opengameart

And clone the repo:

git clone https://bitbucket.org/JemimaLight/opengameart.git

And then add the remote(change username):

git remote add origin https://YourUsername@bitbucket.org/JemimaLight/opengameart.git

When working on new things make a git branch(for example it is called 'hotfix'): more from bitbucket

git checkout -b hotfix

git add .

git commit -m "Changes made"

git push origin hotfix

If you want to add it back into the main branch submit a pull request from your browser.

To update you repo with the remote repo do:more from bitbucket

git pull

If you are using the GUI version of Git lots of these are easy button presses.

##Heroku We can use Heroku for live testing.

Download from above, install and make an account. Then you can login.

heroku login

heroku create

You can test it before uploading it to Heroku by using

foreman start

Foreman comes installed with Heroku.

Once ready for a live test:

git push heroku master

And to check it out:

heroku ps:scale web=1

heroku open