Skip to content

Asset tracker app for the Particle Electron

Notifications You must be signed in to change notification settings

TheraPDX/asset-tracker

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Asset Tracker

An asset tracker app for the Particle Electron, made with Meteor. The project includes an Electron firmware and a mobile-friendly web app that shows the locations of your assets on a map. Get notified via SMS when an asset is moved and watch/record the route that it's taking in real time!

Screenshots

Preview

Setup

In order to deploy and use the application, you need:

  • Particle Electron Asset Tracker Kit
  • Server capable of running Meteor or a Galaxy subscription and MongoDB
  • Twilio account (a free trial account should be sufficient)
  • Mapbox account (also free)

Mapbox

The map component is provided by Mapbox. You can create your own style in Mapbox Studio or import the custom style of this project from mapbox/style.json into your Mapbox account.

Configuration

There are two configuration files that you have to extend with your own account data and tokens.

app/imports/mapbox.js:

export const Mapbox = {
  accessToken: '<access token>',
  styleUrl: 'mapbox://styles/<username>/<style>'
};

app/imports/secrets.js:

export const Secrets = {
  Particle: {
    username: '<email>',
    password: '<password>'
  },

  Twilio: {
    accountSid: '<account SID>',
    authToken: '<auth token>',
    from: '<sender phone number>'
  }
};

Users

To create user accounts, add the required information to app/private/users.json. The server reads this file when it starts and adds the accounts. Alarm messages are sent to the phone number that you specify here. Note that you can only send to verified numbers if you are using a Twilio trial account.

{
  "<email>": {
    "password": "<password>",
    "phone": "<phone number>"
  }
}

Trackers

Trackers are imported from app/private/trackers.json on server startup.

{
  "<email>": [
    {
      "particleId": "<Electron device ID>",
      "name": "<display name>"
    }
  ]
}

Sprite sheets

Sprite sheets for standard and retina resolutions are generated from images in the assets folder using Gulp.

cd tools
npm install
cd sprite
gulp

License

Copyright © Christian Klaussner
License: GPLv3

Entypo pictograms by Daniel Bruce — www.entypo.com

About

Asset tracker app for the Particle Electron

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published