Geopulse

Intro

Geopulse is a web app to showcase local content in your area. Currently it shows your location on a map, the weather, photos, tweets and videos within 5km.

If you find any bugs or have a question, submit it as a GitHub Issue!

Build

1. Clone repository locally
2. Copy .env.sample to .env and add any API keys as needed
3. Run yarn && yarn dev
4. Open http://localhost:3000 in your browser

Tests

1. Run yarn test to run tests once
2. Run yarn test --watch to automatically run when a test file changes

Workflow

1. Hit the landing page
2. Geolocation is approximated based on IP address
3. Start loading content with latitude + longitude and show loading animation until ready
   • Map (Google Maps)
     • Visual of your approximate current location
   • Weather (Weather Underground)
     • Current weather based on latitude + longitude
   • Photos (Instagram)
     • Up to 6 photos posted within 5km of latitude + longitude
     • Note: This will only work with Instagram accounts added to the sandbox application. If you build locally and add your own Instagram API Keys it will work.
   • Chatter (Twitter)
     • Up to 4 tweets posted within 5km of latitude + longitude
   • Videos (YouTube)
     • Up to 4 videos posted within 5km of latitude + longitude
4. User clicks to improve accuracy (share location via browser)
   • If accepted, load more accurate content
   • If declined, show geolocation unavailable screen

Roadmap

• See enhancements

Technologies

• ifconfig.io (Local IP lookup)
• freegeoip.net (External IP lookup)
• Google Maps
• Weather Underground
• Instagram
• Twitter
• YouTube