A modern, full-stack, multi-role e-commerce platform built with Flutter and PHP.
Sire is a comprehensive e-commerce solution designed for customers, delivery personnel, and administrators. It offers a seamless shopping, delivery, and management experience across mobile, web, and desktop platforms. Sire is open-source, modular, and built for scalability and maintainability.
- User Authentication: Sign up, login, password reset, and email verification
- Product Browsing & Search: Explore products by category, search, and view details
- Favorites & Cart: Add products to favorites and manage your shopping cart
- Checkout & Orders: Place orders, apply coupons, and track order statuses
- Address Management: Add, update, and select delivery addresses with GPS coordinates
- Notifications: Real-time updates for orders, offers, and system messages
- Ratings & Reviews: Rate products and view community feedback
- Multi-language Support: Localized for Arabic, English, and Spanish
- Order Management: Accept and manage deliveries, update order status
- GPS Navigation: Integrated Google Maps for route optimization
- Real-time Tracking: Live order tracking and status updates
- Delivery History: Complete delivery history and earnings tracking
- Dashboard Analytics: Comprehensive sales and performance metrics
- Product Management: Add, edit, and manage products with multi-language support
- Category Management: Organize products with hierarchical categories
- Order Management: Process orders, manage inventory, and track deliveries
- User Management: Manage customer accounts and delivery personnel
- Coupon System: Create and manage discount coupons
- Notification System: Send push notifications to users and delivery personnel
- Reports & Analytics: Detailed sales reports and business insights
 |
 |
 |
 |
 |
|---|---|---|---|---|
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
|---|---|---|---|---|
 |
 |
 |
 |
 |
 |
 |
|---|---|---|---|---|
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
 |
- Flutter 3.6.2+ (Dart)
- GetX (state management, routing)
- Material Design 3
- Firebase Messaging (push notifications)
- Google Maps Flutter (location services)
- Lottie (animations)
- Cached Network Image (image caching)
- Shared Preferences (local storage)
- HTTP (API communication)
- Image Picker (file uploads)
- Geolocator (GPS services)
- Flutter Local Notifications (local notifications)
- Cloud Firestore (real-time database)
- Syncfusion Charts (analytics charts)
- Shimmer (loading effects)
- Permission Handler (device permissions)
- PHP 8.2+
- PDO (database abstraction)
- MySQL/MariaDB (database)
- Firebase Cloud Messaging (push notifications)
- JWT (authentication tokens)
- CORS (cross-origin requests)
- Users: Customer accounts with authentication
- Items: Products with multi-language support (EN/AR/ES)
- Categories: Product categorization
- Orders: Order management and tracking
- Cart: Shopping cart functionality
- Favorites: User wishlists
- Address: Delivery addresses with GPS coordinates
- Rating: Product reviews and ratings
- Coupon: Discount system
- Delivery: Delivery personnel management
- Notification: Push notification system
- Git
- Android Studio / Xcode
- Composer (PHP dependency management)
- Flutter Launcher Icons (app icons)
- Flutter Native Splash (splash screen)
- Flutter 3.6.2+ (Install Guide)
- PHP 8.2+ and Composer
- MySQL/MariaDB 10.4+
- Git
git clone https://github.com/abdulwahed-s/sire.git
cd sireflutter pub getcd backend
composer install # If you have composer dependencies- Create a MySQL database named
ecommerce - Import the database schema:
mysql -u root -p ecommerce < backend/ecommerce.sql - Update database credentials in
backend/connect.php:$dsn = "mysql:host=localhost;dbname=ecommerce"; $user = "your_username"; $pass = "your_password";
- Update API base URLs in
lib/apilink.dartto match your backend host - Ensure CORS headers are properly configured in
backend/connect.php
- Create a Firebase project
- Add your
google-services.json(Android) andGoogleService-Info.plist(iOS) - Configure Firebase Cloud Messaging for push notifications
# Generate app icons
flutter pub run flutter_launcher_icons
# Generate splash screen
flutter pub run flutter_native_splash:create- Development:
cd backend php -S localhost:8000 - Production:
Deploybackend/to your web server (Apache/Nginx with PHP & MySQL)
- Development:
flutter run
- Production Builds:
- Android:
flutter build apk --release - iOS:
flutter build ios --release - Web:
flutter build web - Windows/Mac/Linux:
flutter build windows|macos|linux
- Android:
- Web: Deploy
build/web/to any static web host (Netlify, Vercel, Firebase Hosting) - Mobile: Distribute built APKs/IPAs through app stores
- Desktop: Distribute executables for Windows/Mac/Linux
- Deploy
backend/to a PHP-enabled server with MySQL - Ensure proper file permissions and CORS configuration
- Set up SSL certificates for production
- Use managed database services (AWS RDS, Google Cloud SQL, etc.)
- Implement regular backups and monitoring
We welcome contributions!
Quick Start:
- Fork the repo and clone your fork
- Create a new branch:
git checkout -b feature/your-feature-name - Make your changes and commit with clear messages
- Push to your fork and open a Pull Request
Code Style:
- Use
flutter format .for Dart code - Follow Effective Dart guidelines
- Follow PSR-12 for PHP code
- Write clear, descriptive commit messages
This project is licensed under the MIT License.
Author: Abdulwahed
For questions, suggestions, or support, please open an issue or contact via GitHub.
Sire: A modern, open-source e-commerce platform for everyone.