README.md

Play Weather

Status

The Idea

Weather mood expressed in music.

Screenshots

How it works

• Visit Play Weather
• Enter your location into the text field above
• ... or press the button with a globe icon to find your current geo location
• Press 'Play' button to request a weather forecast
• Listen to the music expressing the weather today
• Overview the weather for the next 5 days
• Share it with friends!

Application Concept

• One-page application
• Responsive web design
• Cross-platform

Application Tech Stack

Engine

• Marionette.js
• Backbone.js and Underscore.js
• jQuery and jQuery plugins
• Moment.js
• Require.js
• Webpack
• (originally) Yeoman, Grunt.js, Bower as build tools
• CoffeeScript
• HAML and SASS
• HTML5 and CSS3

Design

• GroundworkCSS grid framework
• Font Awesome icons

Used APIs

• Jamendo API
• Open Weather Map API
• (originally) Panoramio API
• Google Geocoding API
• HTML5 Geolocation API

Application Usage

Requirements

• Node.js

Install

git clone git://github.com/rubycluster/playweather.git
cd playweather
npm install

Configure

Copy example config files and add your own keys and values:

cp app/scripts/config/settings/keys.coffee.example \
   app/scripts/config/settings/keys.coffee

Start development server

webpack-dev-server

Application is now available at:

http://localhost:8080

Build application

gulp build

License

The MIT License (MIT)

Copyright (c) 2013-2016 Vlad Alive

Credits

Developed by Vlad Alive at Ruby Cluster for Jamendo Contest