I Love Open Source

Proclaim your support for your favourite Open Source projects and help OS developers feel the love.

Please go to http://iloveopensource.io to find out more.

##Purpose I Love Open Source is a way of encouraging users of Open Source code to express their gratitude through a simple acknowledgement page. Along the way, they are gently offered a chance to donate cash or just thanks.

This short video explains things properly.

##Our "I Love Open Source" acknowledgments We use I Love Open Source ourselves. Click on the button below to see our Supporter page.

##How it came about When the Codio team were preparing the website, we wanted to show public support for the open source projects we use. We didn't want to just give private donations or statements of support, which no-one was aware of other than the recipient. We wanted to list the projects for all to see, both from the website and the product itself.

That simple start developed into a case of massive scope creep and we added more and more functionality until it ended up as a complete application.

Importantly, I Love Open Source is not just for Open Source developers. Commercial organizations who use Open Source but may not develop Open Source projects themselves now have a perfect means of acknowledgement. Giving acknowledgement and occasionally donations improves the overall health of the OS development community and helps OS developers to keep on developing.

##Sponsor Thanks

• Codio : I Love Open Source is coded and (currently) maintained by Codio developers
• Digital Ocean : All of the cloud hosting is provided free of charge by Digital Ocean.

#Developer Information If you are interested in contributing to I Love Open Source, please read this section.

If you want to discuss general ideas please contact fmay at codio.com. For general stuff, please use GitHub Issues.

Getting Started

Install Node, NPM and Grunt, then install our dependencies:

$ npm install

CSS and Grunt

This app uses LessCSS for it's CSS, and needs to be compiled to run in the browser. So we created a couple of Grunt tasks to help you along:

• grunt build will compile all Less into css/main.css.
• grunt build:prod will build app for production.
• grunt update will fetch all vendors js and build app for production.
• grunt watch will watch all Less files for changes, and recompile when changes are encountered.

JS and Bower

This app uses bower wrapper grunt-bower-task as provider for vendors js:

• grunt bower will install all dependencies.

Configuration

Create file config..js in ./config folder (environment by default is 'development').

• ./config/index.js file showing list of all options
• example.config.js - skeleton for new configuration files

Deploying

The Capistrano Ruby Gem is used to deploy this app.

Run Bundler to install Capistrano and its requirements:

$ bundle install

NOTE: Deploying requires that you have your public SSH key installed on the staging and production servers.

To deploy to production (be careful):

$ cap production deploy

To deploy to staging (http://staging.iloveopensource.io/):

$ cap staging deploy

Running

• node ./app.js or forever ./app.js for development environment
• NODE_ENV=production node ./app.js for production environment