TAMAM Shop is a comprehensive Flutter customer application that serves as the primary interface for customers to access multi-vendor delivery services across Kurdistan and Iraq. The app provides seamless shopping experiences for food delivery, grocery shopping, pharmacy services, and parcel delivery.
- Food Lovers: Restaurant and cuisine discovery
- Busy Professionals: Quick meal and grocery ordering
- Families: Household shopping and bulk orders
- Health-conscious Users: Pharmacy and wellness services
- Local Residents: Neighborhood store access
- Restaurant Delivery: Browse and order from local restaurants
- Grocery Shopping: Fresh produce, pantry items, household goods
- Pharmacy Services: Prescription and over-the-counter medications
- Local Stores: Small businesses and specialty shops
- Parcel Delivery: Send and receive packages
- Smart Search: AI-powered product and restaurant discovery
- Personalized Recommendations: Based on order history and preferences
- Advanced Filters: Price, rating, delivery time, cuisine type
- Wishlist & Favorites: Save preferred items and restaurants
- Quick Reorder: One-tap repeat previous orders
- Real-time Tracking: Live order and delivery tracking
- Order History: Complete purchase history with reorder options
- Order Customization: Special instructions, allergies, preferences
- Group Orders: Collaborative ordering for families and offices
- Scheduled Orders: Advance ordering for future delivery
- Multiple Payment Methods: Card, cash, digital wallets
- Secure Transactions: End-to-end encrypted payments
- Loyalty Program: Points, rewards, and exclusive offers
- Promotional Codes: Discount codes and special offers
- Split Payments: Group payment options
- Flutter: Cross-platform development framework
- Dart: Programming language
- State Management: GetX/Provider for reactive programming
- Local Storage: Hive for offline data and preferences
- HTTP Client: Dio for efficient API communication
- Maps Integration: Google Maps for location services
- Push Notifications: Firebase Cloud Messaging
- Image Caching: Optimized image loading and caching
- Offline Support: Basic functionality during poor connectivity
- Background Tasks: Order status updates and notifications
- REST API: Laravel backend integration
- Real-time Updates: WebSocket for live order tracking
- Authentication: JWT token-based security
- File Upload: Image upload for profile and reviews
- Caching Strategy: Smart data caching for performance
lib/
├── main.dart # Application entry point
├── api/ # API services and endpoints
├── common/ # Shared components and widgets
├── features/ # Feature-based architecture
│ ├── auth/ # Authentication module
│ ├── home/ # Home screen and discovery
│ ├── restaurants/ # Restaurant browsing
│ ├── products/ # Product catalog
│ ├── cart/ # Shopping cart
│ ├── orders/ # Order management
│ ├── profile/ # User profile
│ ├── payments/ # Payment processing
│ └── tracking/ # Order tracking
├── helper/ # Utility functions
├── interfaces/ # Abstract interfaces
├── local/ # Local data management
├── theme/ # App theming and styles
└── util/ # Helper utilities
- Flutter 3.16 or higher
- Dart 3.2 or higher
- iOS 12.0+ / Android API 21+
- Valid Google Maps API key
- Firebase project configuration
# Clone the repository
git clone [repository-url]
cd TamamShop
# Install Flutter dependencies
flutter pub get
# Configure FVM (Flutter Version Management)
fvm use 3.16.0
# Set up environment variables
# Configure Google Maps API key
# Set up Firebase configuration
# Run the application
flutter run
# Build for production
flutter build apk --release # Android
flutter build ios --release # iOS- Firebase: Push notifications, analytics, crashlytics
- Google Maps: Location services and store mapping
- Payment Gateways: Integration with local payment providers
- Environment: Development/staging/production environments
- Arabic (ar): Complete RTL support with cultural preferences
- English (en): International English for broader accessibility
- Kurdish Sorani (ckb): Native Kurdish language with local context
- Local Cuisine: Kurdistan and Iraqi traditional foods
- Cultural Calendar: Religious holidays and local events
- Local Payment: Support for regional payment methods
- Neighborhood Focus: Location-based local business discovery
- Traditional Cuisine: Kurdish, Arabic, and regional specialties
- International Food: Pizza, burgers, Asian cuisine
- Healthy Options: Salads, vegan, gluten-free options
- Desserts & Sweets: Traditional and modern desserts
- Beverages: Fresh juices, coffee, traditional drinks
- Fresh Produce: Fruits, vegetables, herbs
- Pantry Staples: Rice, flour, spices, canned goods
- Dairy & Meat: Fresh dairy products and meat
- Household Items: Cleaning supplies, personal care
- Baby & Kids: Baby food, diapers, toys
- Prescription Medications: Doctor-prescribed medicines
- Over-the-Counter: Pain relievers, vitamins, supplements
- Health Monitoring: Blood pressure monitors, thermometers
- Personal Care: Skincare, hygiene products
- Emergency Services: Urgent medication delivery
- Smart Recommendations: AI-powered suggestions
- Order History Analytics: Favorite items and patterns
- Dietary Preferences: Vegetarian, halal, allergen-free options
- Budget Tracking: Spending insights and budget alerts
- Seasonal Recommendations: Weather and time-based suggestions
- Reviews & Ratings: Community-driven feedback system
- Photo Sharing: Share food photos and experiences
- Friend Referrals: Invite friends with rewards
- Social Login: Facebook, Google authentication options
- Community Events: Local food events and promotions
- End-to-End Encryption: Secure data transmission
- Privacy Controls: User data management options
- GDPR Compliance: European privacy regulation compliance
- Local Data Laws: Kurdistan and Iraq data protection
- Secure Storage: Encrypted local data storage
- PCI Compliance: Payment card industry standards
- Tokenized Payments: No card details stored locally
- Fraud Detection: Advanced fraud prevention
- Secure Checkout: Multi-layer payment verification
- Biometric Authentication: Fingerprint and face recognition
- Fast Loading: Optimized app startup and screen transitions
- Image Optimization: Compressed images with smart caching
- Network Efficiency: Minimal data usage optimization
- Battery Management: Efficient background processes
- Memory Management: Smart memory usage and cleanup
- Offline Mode: Basic functionality without internet
- Quick Actions: One-tap frequent actions
- Smart Notifications: Relevant and timely notifications
- Progressive Loading: Smooth data loading experiences
- Error Handling: Graceful error messages and recovery
- Mobile Development:
datacode-mobile(kurdapp.com@gmail.com) - Backend Integration: Laravel API development team
- UI/UX Design: User experience and interface designers
- Quality Assurance: Testing and validation specialists
- DevOps: Deployment and infrastructure management
- Contact: info@datacode.app
Advanced multi-user git workflow system:
# Smart commit workflow
./scripts/git/smart-commit.sh
# Automated features:
# - Mobile team user attribution
# - AI-generated commit messages
# - Conventional commit standards
# - Automated branch management- Bundle ID: com.tamam.customer
- Target iOS Version: 12.0+
- App Categories: Food & Drink, Shopping, Lifestyle
- Age Rating: 4+ (suitable for all ages)
- Package Name: com.tamam.customer
- Target Android API: 21+ (Android 5.0+)
- App Categories: Food & Drink, Shopping, Lifestyle
- Content Rating: Everyone
- Voice Ordering: Voice-based product search and ordering
- AR Product View: Augmented reality product preview
- Smart Shopping Lists: AI-generated shopping suggestions
- Subscription Services: Regular delivery subscriptions
- Group Buying: Community bulk purchase discounts
- Predictive Ordering: AI-based automatic reordering
- Drone Delivery: Integration with drone delivery services
- Smart Home Integration: IoT device connectivity
- Sustainable Options: Carbon-neutral delivery choices
- Virtual Store Tours: 360° virtual shopping experiences
- In-app Chat: 24/7 customer service chat
- Help Center: Comprehensive FAQ and guides
- Video Tutorials: Step-by-step app usage guides
- Community Forum: User discussion and tips sharing
- Developer Contact: datacode-mobile team
- General Contact: info@datacode.app
- Bug Reporting: Integrated bug reporting system
- Feature Requests: User-driven feature voting
- API Documentation: Third-party integration docs
TAMAM Shop - Your gateway to Kurdistan and Iraq's local businesses, delivering convenience, quality, and community connection right to your doorstep.
Developed by Datacode