Case study 01Enterprise · Hajj & Umrah
Rafiq Al Hajj
An enterprise Hajj & Umrah platform built from 45+ Flutter feature modules.
On the stores
- Role
- Mobile Team Lead — architecture, delivery and the Flutter team
- Company
- ATAM Digital Solution
- Stack
- Flutter
- Dart
- BLoC
- Modular architecture
- WebSockets
- BLE
- Firebase
- OpenAI API
- Shorebird
- CI/CD
01
The product
Rafiq Al Hajj is an enterprise-scale Hajj & Umrah platform that manages pilgrim journeys through multi-role operational systems. Live pilgrim tracking, transportation coordination, SOS workflows and operational dashboards come together in one Arabic and English product, serving thousands of users across multiple operational regions.
The mobile codebase is a multi-tenant Flutter architecture of more than 45 feature modules, with real-time communication over WebSockets, BLE-based Tafweej tracking, Firebase Cloud Messaging and AI assistant features built on the OpenAI API.
During active Hajj seasons, production hotfixes ship over the air with Shorebird instead of waiting for a full store release.
02
Screens
Screenshots from the product.
03
The challenge
01
Scale without entanglement
45+ feature modules have to stay independent, consistent and buildable in parallel, so boundaries, shared conventions and dependency rules matter as much as the features themselves.
02
Real-time, end to end
WebSocket events, push messages and BLE tracking feed the same experience. The app has to reconcile live data streams into clear, predictable UI state.
03
Critical-path workflows
SOS and transportation flows are the moments that matter most. They have to be fast to reach, hard to get wrong and resilient to failure.
04
Fixes that can't wait
There is no time for a store review cycle in the middle of Hajj. Over-the-air hotfixes with Shorebird get critical fixes to users while the season is running.
05
Arabic and English, both first-class
A bilingual experience means localisation and layout direction are designed in from the start, not added at the end.
04
My role
Mobile Team Lead — architecture, delivery and the Flutter team · ATAM Digital Solution
What I built
- Live pilgrim tracking
- BLE Tafweej tracking
- SOS workflows
- Transportation coordination
- Real-time updates over WebSockets
- Operational dashboards
- Push notifications with Firebase Cloud Messaging
- AI assistant features with the OpenAI API
- OTA production hotfixes with Shorebird
- Arabic & English
05
Architecture
The layers of the system, from what people touch to how it ships. Every item comes from the project's stack.
Presentation
- Flutter
- Dart
- Arabic & English
Modules & state
- Modular architecture · 45+ feature modules
- BLoC
- Multi-tenant
Real-time & data
- WebSockets
- BLE
- Firebase Cloud Messaging
Services
- Firebase
- OpenAI API
Delivery
- CI/CD
- Shorebird OTA
06
Engineering
Real-time over WebSockets
WebSocket events, push messages and BLE tracking are reconciled into clear, predictable UI state.
BLE Tafweej tracking
Bluetooth Low Energy tracking feeds the same live experience as the network streams.
Push notifications
Firebase Cloud Messaging for messages to app users.
OTA hotfixes
Shorebird ships critical production fixes during the Hajj season, without waiting for a store release.
AI assistant
Assistant features built on the OpenAI API.
Arabic & English
Localisation and layout direction designed in from the start.
07
Product flow
- 01
Pilgrim journey
Each pilgrim's journey runs through one Arabic and English app.
- 02
Live tracking
Live pilgrim tracking over WebSockets, with BLE Tafweej tracking.
- 03
Transportation
Transportation is coordinated inside the same system.
- 04
SOS
SOS workflows: fast to reach, hard to get wrong.
- 05
Operations
Operational dashboards bring the live picture together.