A production-ready commercial marketplace platform for Yemeni retail — three integrated apps (Customer, Merchant, Admin) with real-time promotions, multi-city filtering, push notifications, and scalable REST APIs.
An end‑to‑end commercial offers ecosystem that connects malls, supermarkets, and retailers directly with consumers. The platform consists of three integrated applications — Customer App, Merchant App, and Admin Dashboard — all powered by a unified Laravel REST API and real‑time Firebase Cloud Messaging.
This is not a simple offers app — it is a production‑ready ecosystem designed to organize and facilitate commercial discounts for the Yemeni market.
Designed and developed as a full marketplace solution for the Yemeni retail sector, enabling merchants to self‑manage discounts, consumers to browse offers by city and category, and admins to supervise the entire cycle — from store approval to notification dispatch.
| Metric | Value |
|---|---|
| Applications | 3 (Customer, Merchant, Admin) |
| RESTful APIs | 90+ |
| Flutter Screens | 35+ |
| Notifications | FCM (real‑time) |
| Filtering | Multi‑city & Category |
Flutter Dart Laravel (PHP) MySQL Firebase FCM RESTful APIs Provider / BLoC Git & GitHub
- ✅ Designed the database schema and relationships between stores, discounts, and cities
- ✅ Developed the Customer and Merchant apps using Flutter with Clean Architecture and state management
- ✅ Built the backend with Laravel, delivering 90+ secure and scalable RESTful endpoints
- ✅ Integrated Firebase Cloud Messaging (FCM) to notify users about new deals in real time
- ✅ Created the admin panel for supervising stores, approving offers, and managing categories
- ✅ Implemented geographic filtering by Yemeni cities and commercial categories
| Feature | Description |
|---|---|
| 🌆 Multi-City Filtering | Seamless, instant filtering by city (Sana'a, Aden, Taiz, etc.) and commercial categories |
| ⏱️ Real-Time Countdowns | Accurate timers for active/expired offers with distinct visual states |
| 🏬 Merchant Self-Management | A dedicated merchant app to independently add, edit, and manage discounts |
- Browse offers by category (Clothing, Electronics, Home Appliances, etc.)
- Interactive store page with history of previous offers
- Instant push notifications when new offers are added
- Share offers via social media
- Quick search for stores or products
Click to watch the Customer App walkthrough — browsing deals, selecting cities, and countdown timers in action.
| Home Page | Categories | Store Page |
|---|---|---|
 |
 |
 |
| Select City | Interactive Store |
|---|---|
 |
 |
Built a smart logic engine on the mobile side to calculate validity periods and automatically update offer status once the timer expires, without requiring a page reload.
Optimized MySQL queries by adding indexes on cities and categories, ensuring minimal API response times even with a large number of stores and offers.
- Architecting a multi‑actor ecosystem and distributing logic across mobile apps and backend
- Efficiently managing real‑time timers and offer states in mobile applications
- Designing a fast and simple user experience tailored to daily browsing of commercial offers
- 🌐 Portfolio: amartomas-portfolio.web.app
- 📂 Repository: Yemen Offers on GitHub
⭐ If you find this project useful, consider giving it a star!
🤝 Collaboration or custom development inquiries are welcome — reach out via LinkedIn or email.