# transitpin


> **Owner:** Germaine | **Status:** LIVE (dev)
> **Last Updated:** 2026-08-09

TransitPin is a real-time student transportation tracking SaaS built for the private contractor market — the companies school districts hire to move students. It replaces paper route sheets, manual parent texts, and clipboards with a live GPS platform: driver PWA, parent ETA portal, bell-schedule intelligence, and an admin dashboard for owners.

Built from a direct client engagement with Village Express Transportation (Savannah, GA).

## Access

| Resource | URL | Location | Notes |
|---|---|---|---|
| Parent Portal | https://villageexpress.transitpin.com/ | Core (152.53.192.33) | Caddy reverse proxy |
| Driver PWA | https://villageexpress.transitpin.com/driver.html | Core | WebSocket at /ws/driver* |
| Admin Dashboard | https://villageexpress.transitpin.com/admin.html | Core | Dispatch map, driver tracking |
| WebSocket Relay | port 8210 (localhost) | Core | systemd: village-express.service |

## Tech Stack

- Frontend: Vanilla HTML/CSS/JS, Leaflet maps, TomTom traffic tiles
- Backend: WebSocket relay (Node.js), systemd service
- Reverse Proxy: Caddy (TLS auto-provision)
- GPS: Browser `watchPosition` API, Wake Lock API
- Data: driver-manifest.json (static routes), PWA manifest

## Quick Start

```bash
git clone https://git.itpropartner.com/ippadmin/transitpin.git
cd transitpin/
# Start WebSocket relay
sudo systemctl start village-express
# Caddy serves static files + proxies /ws/* to WebSocket relay
```

## Related

- [itpp-infrastructure](https://git.itpropartner.com/ippadmin/itpp-infrastructure) — server inventory, DNS
- [itpp-standards](https://git.itpropartner.com/ippadmin/itpp-standards) — docs standards and templates
- [transitpin-white-label](https://git.itpropartner.com/ippadmin/transitpin-white-label) — white-label portal builder