Germaine Brown
98073dc636
Publish Docs Site / build (push) Failing after 5s
- mkdocs.yml with dark slate theme, nav for 12 ITPP projects - build-docs.sh aggregates docs from all project repos - .gitea/workflows/docs-publish.yml for nightly rebuild+deploy - README and CHANGELOG for the itpp-docs repo itself - docs-source/ populated from all 12 repos - site/ ready for deployment to docs.itpropartner.com
43 lines
1.8 KiB
Markdown
43 lines
1.8 KiB
Markdown
# 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
|