Package Tracker

A simple tool to keep track of multiple packages from various carriers all in one place and saved to Firestore.

Currently supports the following carriers:

USPS
UPS (directs to Bing search, since it has the most tracking info)
Fedex
Amazon (only supports Order-ID values)
DHL
LaserShip

WIP

This is a WIP project, so while it's perfectly usable there might be weird bugs and issues.

How to get started

This requires you to use Firestore to store your package details.

Make sure you have a firebase/firestore set up in GCP.

Add a firebaseCreds.js to the src/firebase directory with your respective credentials.

export const creds = {
  apiKey: '',
  authDomain: '',
  databaseURL: '',
  projectId: '',
  storageBucket: '',
  messagingSenderId: '',
  appId: '',
};

The frontend is password protected. To make use of this locally, add a password.js file in /src/.

export const authPassword = {
  password: 'yourPassword',
};

and then

npm install
npm start

To-do

• UI
  • Add package section
  • Package list/history
  • Flesh out UI/CSS better
  • Figure out how to make responsive on mobile
  • Display error/retry button if fail to fetch data
  • Automagically detect carrier
  • Automagically detect delivered status, requires deeper connection to carrier
• Attach firestore
• Configure firestore
• Push data to firestore
• Pull data from firestore
• More polish
• Typescript because i was naive and started with JS
• More carrier support
• Better auth

Preview