Code Monkey home page Code Monkey logo

moves-on-deck's Introduction

Moves On Deck

Moves On Deck is a WebGL-powered visualization of your Moves app location history, built with React and Uber's deck.gl framework.

Usage

This project is currently available at https://apps.claygregory.com/moves-on-deck/. Data processing is entirely client-side in browser, so there's no need to deploy your own copy if just interested as an end-user.

Development

If you're interested in local development, the provided Gulpfile will allow you build and run your own copy. However, you'll need to supply your own Mapbox API key.

Setup

From the project root, install the required dependencies with either NPM or Yarn:

npm install

or

yarn

Environmental Variables

To use the Mapbox layer, you'll need to supply the your own Mapbox API key, via the MAPBOX_ACCESS_TOKEN environmental variable. This can be provided on the command line, or placed in a .env file at the project root. Your can request a free key from Mapbox for limited usage.

Running Locally

By default, Gulp will build the project and launch a local webserver on port 8000 with hot-reloading enabled. Be sure you've provided the Mapbox API key as described above.

MAPBOX_ACCESS_TOKEN=your_token gulp

Production Build

As with a dev build, you'll need to supply a Mapbox API key as described above. This key will be statically inlined to your production build using envify, ready for distribution. Running with --type=production will also compress and uglify the build:

MAPBOX_ACCESS_TOKEN=your_token gulp --type=production build

The contents of the dist directory are then ready to deploy to a static web server.

License

See the included LICENSE for rights and limitations under the terms of the MIT license.

moves-on-deck's People

Contributors

claygregory avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar

Forkers

dotkrnl

moves-on-deck's Issues

Not parsing storyline json files without place.name="Home"

Thank you a lot for this great app for people to parse Moves json data!

When processing my Moves storyline.json, an error Oops, the file you provided doesn't look like a Moves storyline would be shown.

After investigation, I found it occurred in function locateHome in app/js/util.js which is attempting to find a location with place.name==='Home'.

I would suggest having a fallback location when Home absent. Or warns non-developers to add a location with name="Home".

Thank you again! This app is awesome!

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.