Realtime Package Tracker

A web application that ingests payloads from a HTTP integration and displays them on a map in realtime. The app tracks package locations and displays the history of where the package has been.

Features

  • HTTP endpoint to receive location data from ChirpStack
  • Interactive map showing current and historical package locations
  • Automatic map zooming to show all locations
  • Detailed metadata view when clicking on a location point
  • Persistent storage of location history

Project Structure

  • /backend - Server-side code for the HTTP endpoint and API
  • /frontend - Client-side code for the map interface
  • /shared - Shared types and utilities

Technologies Used

  • Backend: Hono (API framework)
  • Database: SQLite for persistent storage
  • Frontend: HTML, CSS, JavaScript with Leaflet.js for mapping
  • TypeScript for type safety

Getting Started

  1. The application will automatically receive data from ChirpStack when properly configured
  2. Visit the main page to view the package tracker interface
  3. Click on any location marker to view detailed metadata