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.
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci
client
config
data/fixtures
server
.babelrc
.env.sample
.gitignore
README.md
package.json
server.js
yarn.lock

README.md

Geopulse

CircleCI Maintainability

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. View it on the web at https://geopul.se.

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

Technologies