# Deliverist Mobile App

Case study by Devansh Tiwari (https://www.devanshtiwari.com) · https://www.devanshtiwari.com/work/deliverist-mobile

Customer-facing logistics app for Saudi Arabia. React Native, real-time tracking, ZATCA-compliant invoicing.

## Key facts

- Role: Sole Developer
- Client: OSIT / Deliverist
- Year: 2025
- Status: Shipped
- Tech: React Native, Expo, TypeScript, Zustand, React Query, i18next, Google Maps, NativeWind

## At a glance

- Problem: Saudi delivery apps treat Arabic and cash on delivery as afterthoughts.
- What I built: An Arabic-first React Native app for booking and tracking deliveries.
- Result: Customers pay the way they want, cash included, and get a valid tax invoice on the phone.

## Numbers

| Metric | Value |
| --- | --- |
| Payment methods | 10+ |
| Tax invoices on the phone | ZATCA |
| App screens | 20+ |
| Ways to set an address | 3 |

Values with a + are public figures rounded down.

## The problem

Saudi logistics is crowded. Aramex, SMSA, and J&T all compete for the same customers. Most apps treat Arabic as an afterthought and bolt on COD support last, even though COD accounts for 60 to 70 percent of Saudi e-commerce transactions. Deliverist needed a mobile app that worked Arabic-first from day one, covered the full booking-to-delivery loop in a single interface, and generated invoices that satisfied ZATCA requirements without a separate billing tool.

## What I built

Built the entire customer-facing React Native app as sole developer, covering every screen from onboarding to delivery confirmation. The booking flow is a 4-step wizard that supports three address input methods: dropping a pin on Google Maps, typing a full address manually, or entering a Saudi Short Address Code, which is the format printed on most Saudi utility bills. Real-time shipment tracking renders a visual status timeline via a public API endpoint, so recipients can check progress without logging in. Invoice PDF generation runs on-device: bilingual Arabic/English content, a ZATCA-required QR code, 15% VAT calculation, and an Air Waybill with barcode and COD label when applicable. Over 10 payment methods integrated, including local Saudi options. Phone OTP authentication with push notifications for status updates. Every screen ships with full Arabic RTL layout via NativeWind and i18next, with no English-only fallback screens. Zustand manages booking and tracking state across the wizard steps. React Query handles cache invalidation for live shipment status without manual polling logic.

### 4-Step Booking Wizard

Pickup location, destination, item details, and confirmation. Each step validates via Zod schemas. Three address input methods: Google Maps pin drop, manual text entry, or Saudi Short Address Code (printed on utility bills). The wizard persists state across steps so users can navigate back without losing data.

### ZATCA Invoice Generation

On-device PDF generation with bilingual Arabic/English content. Includes a ZATCA-required QR code containing seller info, VAT number, invoice total, and tax breakdown. 15% VAT is computed per line item. Air Waybill with barcode and COD label renders when cash-on-delivery is selected.

### Real-Time Tracking

Public tracking API endpoint with a visual timeline: booked, picked up, in transit, out for delivery, delivered. Recipients check progress without logging in. Push notifications fire at status transitions. React Query handles cache invalidation so the timeline updates without manual pull-to-refresh.

### Arabic-First RTL

Every screen ships with full Arabic RTL layout via NativeWind logical properties and i18next. No English-only fallback screens. Text alignment, icon direction, and wizard step order all flip correctly. The app reads the system locale on launch and sets the direction accordingly.

## Highlights

- ZATCA-compliant invoice PDF generation built from scratch: bilingual content, QR code, 15% VAT line item, and Air Waybill with COD labeling all handled client-side
- 4-step booking wizard with 3 address input methods (Google Maps pin drop, manual text entry, Saudi Short Address Code) covering the full range of how Saudi users share locations
- Public shipment tracking API with visual timeline so recipients can follow their delivery without an account, removing the support burden from the Deliverist team

## Work with Devansh

Devansh Tiwari is an AI product engineer based in India, available for freelance and consulting work: custom data feeds from sites without APIs, AI features (agents, chat, RAG, MCP servers) built on that data, and running them after launch.

- Book a 15 minute call: https://cal.com/devansh0718/15min
- Email: devanshtiwari365@gmail.com
- All case studies: https://www.devanshtiwari.com/work
- Site summary for AI tools: https://www.devanshtiwari.com/llms.txt
