Beta v0.9 Β· POC Release

SafeShip
Tracker

A mobile-first PWA for field delivery teams β€” scan, photograph, geolocate, and sync proof-of-delivery with zero infrastructure dependency.

πŸ“± Installable PWA
πŸ“Ά Works Offline
πŸ“· QR Scanning
πŸ“ GPS Geocoded
πŸ–ΌοΈ Multi-Photo
⚠️

Proof of Concept β€” Beta Platform

This is a demonstration build for customer evaluation only. It does not include driver authentication, role-based access control, or production security hardening. Features marked Coming Soon are proposed for the production release.

Currently Live
Everything It Does Right Now

Twelve real working features β€” all in a lightweight browser app with no native install required.

πŸ“·
QR / Barcode Scanning
Live camera scanning for QR codes and most 1D barcodes via html5-qrcode β€” no native app or App Store needed.
Live
⌨️
Manual Shipment ID Entry
Damaged label? Poor lighting? Driver types the ID directly β€” same processing pipeline as scanned codes.
Live
πŸ“
Address Geocoding
Delivery address stored verbatim and rendered as a clickable Google Maps link in the dispatcher viewer.
Live
πŸ•
Automatic Date & Time Stamp
Timestamp captured at submission. Displayed with full date, 12-hour time, and AM/PM β€” no manual entry needed.
Live
πŸ–ΌοΈ
Multi-Photo Upload
Multiple photos per delivery β€” package, door, label. Server resamples to 1024Γ—768 at 85% JPEG quality to keep storage lean.
Live
πŸ“
Delivery Notes
Free-text field for any context: left with neighbour, access code used, box damaged, recipient refused, etc.
Live
πŸ“Ά
Offline Mode + Auto-Sync
Service Worker caches the full app. Submissions queue locally when offline and sync automatically the moment signal returns β€” no driver action needed.
Live
πŸ“±
Installable PWA
Web App Manifest enables Add to Home Screen on iOS and Android. Runs standalone β€” looks and behaves like a native app without any App Store deployment.
Live
πŸ“¦
Shipment Viewer Dashboard
Browser-based PHP table β€” ID, address, timestamp, thumbnails, notes. Click any thumbnail for a full-size modal with keyboard navigation.
Live
πŸ”
Duplicate Shipment Guard
Server checks for an existing ID before inserting. Duplicate scans or resubmissions are rejected cleanly β€” no double records.
Live
πŸ—ΊοΈ
One-Click Map View
Every address in the viewer links directly to a Google Maps search. Dispatcher confirms delivery location without copy-pasting.
Live
πŸ›
Server-Side Debug Logging
All POST submissions, file uploads, DB writes, and errors are timestamped in debug.log β€” critical for diagnosing offline sync issues in the field.
Live
Driver Workflow
How a Delivery Works

Seven steps from pulling up to the door to the dispatcher seeing proof of delivery.

01

Open the App

Driver taps the SafeShip icon on their home screen. Loads instantly β€” even offline β€” from the Service Worker cache.

02

Scan or Enter ID

Camera activates for live QR/barcode scanning. Unreadable label? Driver types the shipment ID manually.

03

Confirm Address

Delivery address is entered or confirmed. Stored verbatim and linked to Google Maps in the viewer.

04

Photograph It

One or more photos: package at door, recipient, label. Compressed server-side before storage.

05

Add Notes

Any relevant context β€” left with neighbour, gate code, box condition, access issues.

06

Submit

Online: posts immediately. Offline: queued locally and synced automatically when signal returns.

07

View Shipments

Back-office opens the viewer β€” photos, map link, notes, exact timestamp β€” all in one table row.

Production Release
What's Coming Next

Proposed features for a hardened, full production deployment.

πŸ”

Driver Authentication

Unique login per driver. Every submission tied to a named user, not just a device.

Coming Soon
πŸ‘₯

Role-Based Access Control

Driver: submit only. Dispatcher: view all. Admin: manage users, export, configure.

Coming Soon
✍️

Digital Signature Capture

Touch-screen signature pad built into the submission flow. Stored alongside photos.

Coming Soon
πŸ“²

Recipient Notifications

Automated SMS or email on successful delivery β€” includes timestamp and optional photo link.

Coming Soon
❌

Failed Delivery Logging

Structured reason codes for non-delivery. Triggers automatic reattempt scheduling.

Coming Soon
πŸ›£οΈ

Route Optimization

Import a stop list, get an optimized drive sequence via Google Maps or OSRM.

Coming Soon
πŸ“Š

Analytics Dashboard

KPIs: deliveries per driver per day, first-attempt success rate, failed delivery breakdown.

Coming Soon
πŸ“€

CSV / PDF Export

One-click export filtered by date, driver, or status. PDF includes photo thumbnails.

Coming Soon
πŸ“

Live GPS Breadcrumb

Optional background GPS per shift. Dispatcher replays route and verifies delivery coordinates.

Coming Soon
🏒

Bulk Shipment Import

Upload a CSV or scan from a dispatch manifest to pre-load the day's stops and addresses.

Coming Soon
πŸ””

Push Notifications

New stop assigned, route updated, or sync failure β€” delivered as native push to the driver's phone.

Coming Soon
πŸ”—

REST API / Webhooks

Delivery events pushed to a TMS, WMS, or customer portal in real time on submission.

Coming Soon
☁️

Cloud Photo Storage

S3 or Cloudflare R2 for photos. Removes local disk dependency, adds redundancy and CDN speed.

Coming Soon
🌐

Multi-Language UI

French, Spanish, Portuguese β€” auto-detected from browser settings for diverse driver workforces.

Coming Soon
At a Glance
POC vs Production

What's in the demo now versus what ships in full production.

Capability Beta POC Production
QR / Barcode Scanningβœ“βœ“
Manual ID Entryβœ“βœ“
Multi-Photo Captureβœ“βœ“
Address Storage + Map Linkβœ“βœ“
Auto Timestampβœ“βœ“
Delivery Notesβœ“βœ“
Offline Queue + Auto Syncβœ“βœ“
Installable PWAβœ“βœ“
Shipment Viewer Dashboardβœ“βœ“
Duplicate ID Preventionβœ“βœ“
Driver Authenticationβ€”βœ“
Role-Based Access Controlβ€”βœ“
Digital Signature Captureβ€”βœ“
Recipient Notifications (SMS/Email)β€”βœ“
Failed Delivery Reason Codesβ€”βœ“
Route Optimizationβ€”βœ“
Analytics Dashboardβ€”βœ“
CSV / PDF Exportβ€”βœ“
Live GPS Breadcrumbβ€”βœ“
Push Notificationsβ€”βœ“
REST API / Webhooksβ€”βœ“
Cloud Photo Storage (S3/R2)β€”βœ“
Architecture
Technology Stack

Lightweight by design β€” no frameworks, no bloat.

HTML5 / CSS3
Vanilla JavaScript
Service Worker API
Web App Manifest
html5-qrcode
Cache API
PHP 8
PDO / MySQL
GD Image Library
Google Maps Search API