Particle electron web based run tracker built at Calgary Hacks 2018 by @dandua98, @RoyalKingMomo and @seanmai.
Using Particle Electron cellular IoT board provided by TELUS for the Long Range cellular IoT theme.

Idea and Execution

The base idea was too get user location using GPS (which we didn't realize Particle Electron didn't have onboard) and to plot the path on a map which could be shared over social media. Due to lack of accuracy using cellular Geolocation, we decided to manually publish data in a format the AssetTracker GPS shield would have got using the native library to particle cloud and have our board subscribe to the stream, therefore replicating the GPS module until we actually got it.

Also, we provided our own geoLocation dataset for a trial run to map the coordinates on the web framework which can be found at data.json in the repo.

Getting Started


To set up your hardware, check for a detailed explanation and Particle Electron documentation.


The web framework was created using following frameworks and technologies:

  • Node.js
  • Express.js
  • MongoDB

These can be installed using Homebrew, apt-get or the respective package manager for your system.

The main Node Modules used were:

  • Particle-api-js (for particle cloud)
  • Passport (for user authentication)
  • Mongoose (for MongoDB)

A complete listing can be found here.


To install and run, in your command line/terminal tool, run:

$ git clone
$ cd particle_run
$ node app.js

Assumes required packages have been installed

In another terminal, run the MongoDB server

$ cd particle_run
$ mongod

Web framework images

  • User run map screen - To view user's run location, path and other data which can be added as each point is stored as a timestamped node in the database

  • Login screen - To login for a current user and sign up for a new user, additional data like weight and height can later be used for health data

  • Profile screen - To check user past runs and select a run, check other stats and user information (to be implemented, this is just a proof of concept)


  • Danish Dua - Software engineering student at University of Alberta - GitHub
  • Sean Mai - Software engineering student at University of Calgary - GitHub
  • Mohammad Al-Ahdal - Electrical engineering student at University of Alberta - GitHub


The project is licensed under MIT License - see the LICENSE file for details


  • CalgaryHacks2018 organizers and sponsors
  • Any open source codebase that way used in this project

README at the time of submission


we like to run

What it does

tracks your run

How we built it


Challenges we ran into


Accomplishments that we're proud of

how we actually pulled through something amazing after facing so many challenges

What we learned

hardware hacks are hard

What's next for particle_run

not sure yet

Share this project: