Case Study

Leadus — Mobile App

Leadus mobile app (React Native) for Android and iOS: OTP login, business dashboard, SMS/email/Telegram/WhatsApp campaigns, customer club, conferences with ticket check-in, wallet payments, and maps—same FastAPI backend as the Leadus web platform. Download and product site at leadus.ir.

Industry

SaaSLocal businessMarketing automationIranRTL

Role: React Native developer

Duration: Multi-phase delivery

Website

Challenge

Business owners in Iran need full marketing and operations tooling on mobile—maps, media, conference check-in, and multi-channel messaging—while OTP login and APK distribution fit the local ecosystem. The mobile client must stay in sync with the Leadus web dashboard and API.

Solution

Delivered the Leadus React Native app with modular screens mirroring the web dashboard: digital advertising, customer club, conferences, site management, and wallet payments via leadus.ir invoices. Phone OTP login; native camera, maps, PDF, and in-app update checks.

Impact

Owners and field staff run Leadus campaigns and events without a desktop. Conference staff validate tickets on device; messaging reuses the same wallet and reporting as web. APK distribution from leadus.ir supports rollout without depending on app stores.

Tech stack

React NativeReactReact NavigationAxiosAsyncStorageFastAPIMySQLJWTreact-native-mapsmoment-jalaali

Project overview

Leadus is the Persian-first business-management platform for Iranian SMBs. This case study covers the mobile app (Android and iOS): marketing, customer clubs, conferences, and multi-channel messaging on the go—on the same backend as the leadus.ir web dashboard.

What we built

Authentication — Phone OTP login with secure session for API calls.
Business hub — Dashboard (Jalali date, clock, suggested channels), profile and location editing, branches, catalogs, virtual tours, posts, social settings, feature purchase.
Digital advertising — SMS (single, Excel, contacts, regional/map tools, reports), email (settings, templates, send, reports), Telegram, WhatsApp, Eitaa.
Customer club — Members, groups, bulk import, birthday campaigns, appointments, digital business cards, surveys, lucky wheels, lotteries, scheduled SMS, dialer.
Conferences — Create and edit events, registrations, bulk add, SMS blasts, ticket check-in on device.
Wallet & payments — Charge wallet, transaction history; payments open invoice pages on leadus.ir.
Discovery — Search, around-me map views, business profiles, calendar.
Admin — User list, business approval, discount codes for operators with admin access.
Maintenance — In-app update checks for platform-specific APK/iOS prompts.

Technical approach

React Native with stack, drawer, and tab navigation across 100+ screens. Persian UI with LTR layout shell. Native modules for camera, maps, geolocation, PDF/video, file pickers, and connectivity checks. Shared FastAPI + MySQL backend with the Leadus web product.

Distribution & integrations

Android / iOS — React Native builds; APK distribution via leadus.ir.
Web counterpart — Platform and dashboard on leadus.ir (see portfolio entry leadus-web-platform).
Messaging — OTP/SMS, email, Telegram, and WhatsApp integrations on the platform side.

Store listing URLs are optional; rollout emphasized direct APK from leadus.ir.