Routify

Route planning and delivery management for independent couriers
Import your parcels, get the best stop order, deliver with proof, and close the day with a PDF report — all from one app.

Note

Routify is under active development. Branding, naming and visuals are still being finalised with the client and may change.

---

📱 Screens

_{Design previews — the full set lives in design_pref/.}

✨ Features

For riders (mobile app)

• 📥 Add stops your way — import a PDF / Excel / Word manifest, type an address, drop a pin, speak it, or scan an Eircode / barcode with the camera (on-device OCR)
• 🧭 Optimised routes — best stop order for hundreds of stops, with map preview and live navigation
• ✅ Proof of delivery — photo capture, delivered / failed outcomes with reasons, duplicate-stop detection
• 📶 Works offline — actions queue in a local SQLite outbox and sync automatically when the signal comes back
• 📄 Daily PDF reports and full route history
• 💳 Subscriptions — in-app plans through the App Store and Google Play (RevenueCat)
• 🔄 Over-the-air updates with EAS Update

For platform staff (admin console)

• Overview dashboard, riders, deliveries, reports, plans, subscriptions and payments
• Audit logs and platform settings

Under the hood

• Background job worker for heavy route optimisation (never blocks the API)
• Geocoding cache, idempotency keys, rate limiting and token rotation
• Server-Timing headers, Sentry error reporting and performance benchmarks (perf.md)
• Self-hosted OSRM + VROOM road-routing proof of concept for Ireland (infra/routing)

🏗️ Architecture

flowchart LR
    R["📱 Rider app<br/>Expo · React Native"] -->|REST /api/v1 · /v2| API
    A["🖥️ Admin console<br/>React · Vite"] -->|REST /api/v1| API
    subgraph Backend
      API["⚡ FastAPI"] --> DB[("PostgreSQL<br/>Prisma")]
      API --> Q["Job queue"] --> W["⚙️ Worker<br/>route optimisation"]
      W --> DB
      API -.optional.-> RD[("Redis")]
    end
    API --> G["🗺️ Maps & geocoding"]
    API --> S["🧾 App Store · Google Play<br/>RevenueCat"]

Loading

📂 Repository structure

Path	What it is
rider-app/	Rider mobile app — Expo + React Native + TypeScript
admin-web/	Platform admin console — React + TypeScript + Vite
backend-py/	REST API — Python + FastAPI + Prisma + PostgreSQL, with a background worker
infra/routing/	OSRM + VROOM self-hosted routing benchmark (Ireland)
infra/loadtest/	k6 and Locust load-test scenarios
design_pref/	UI design references for every rider screen
render.yaml	Render blueprint for deploying the API

🚀 Getting started

Prerequisites: Python 3.13, Node.js 24, and a PostgreSQL database (a hosted Neon database works, no Docker needed).

Backend — backend-py/

cd backend-py
python -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements-dev.txt
cp .env.example .env            # set DATABASE_URL and the JWT / refresh / file-signing secrets
prisma migrate deploy           # create the tables
python -m scripts.seed_admin    # needs ADMIN_EMAIL + ADMIN_PASSWORD (10+ chars) in .env
python -m app                   # API on http://localhost:4000
python -m app.worker            # route-optimisation worker (separate terminal)
pytest                          # tests run against a real PostgreSQL

Admin console — admin-web/

cd admin-web
cp .env.example .env            # VITE_API_URL=http://localhost:4000
npm install
npm run dev

Rider app — rider-app/

cd rider-app
cp .env.example .env            # EXPO_PUBLIC_API_URL=http://<your-machine-ip>:4000
npm install
npx expo start

Shipping a JS-only fix without a store release (EAS Update):

npx eas-cli@latest update --channel production --environment production --message "<what changed>"

The runtime version is a fingerprint of the native code, so an update never reaches a build with different native modules. After a native change (new module or app.json plugin), make a new build instead.

🧪 Quality

Every push and pull request runs CI:

App	Checks
Backend	ruff lint + pytest against a throwaway PostgreSQL container
Rider app	tsc type-check + expo lint + unit tests
Admin console	tsc type-check + lint

🧰 Tech stack

Layer	Technology
Mobile	React Native 0.86, Expo SDK 57, React Navigation, TanStack Query, Expo SQLite, Vision Camera + OCR, React Native Maps
Admin	React 19, TypeScript, Vite
API	Python, FastAPI, Pydantic, Prisma (prisma-client-py), PostgreSQL
Auth	JWT access tokens + rotating refresh tokens, bcrypt
Payments	App Store Server API, Google Play Developer API, RevenueCat
Ops	Render, Neon, Redis (optional), Sentry, GitHub Actions, EAS Build & Update

👤 Author

Built by Ali Sulman — Full-Stack AI Developer.

---

_{© Routify. All rights reserved. This is a private client project; the source is shared for portfolio purposes.}