🚀 Laundry App SaaS — Laravel 11 + Flutter

A complete, production-ready multi-tenant SaaS application built for laundry businesses. Each merchant gets their own isolated workspace, subscription-gated feature set, and branded experience — out of the box.

Built with Laravel 11 (REST API + Blade Web Dashboard) and Flutter 3.10+ (Mobile & Web), this is a full end-to-end system you can deploy and start selling subscriptions on day one.

✨ Key Features

📱 Merchant Mobile App (Flutter)

• Dashboard — Real-time stats: today's orders, revenue, pending pickups, total customers
• Order Management — Create, track status, view detail, print receipt (thermal & PDF)
• Customer Management — Add/edit customers with full order history
• 3-Factor Pricing — Flexible pricing by Service Type × Duration × Unit
• WhatsApp Notifications — One-tap WA notification to customer on status update
• Bluetooth Thermal Printing — Print receipts to any Bluetooth thermal printer
• PDF Export — Generate & share PDF receipts and reports
• Revenue Reports — Daily & monthly reports with chart visualization
• Multi-user / Staff — Role-based access (Owner vs Staff)
• Multi-language — Indonesian & English (i18n via Flutter ARB)
• Subscription Screen — Self-service subscription status & payment info display

🖥️ Super Admin Web Dashboard (Laravel Blade)

• Merchant Management — View, edit, activate/deactivate merchants & subscriptions
• Subscription Packages — Create/edit plans (Starter, Pro, Enterprise, Yearly)
• Package Change Requests — Approve/reject merchant upgrade requests
• Order & Customer Monitoring — Cross-merchant visibility
• RBAC — Full roles & permissions management
• Admin Notifications — In-app notification bell
• Built-in Landing Page — Marketing page with pricing section included

💳 Subscription Packages

All packages are fully configurable from the admin dashboard — no code changes needed.

🔐 Authentication & Security

• Laravel Sanctum Bearer Token authentication
• Role-Based Access Control (RBAC): super_admin, merchant_owner, merchant_staff
• Subscription gate middleware — expired subscriptions return 402, Flutter catches and redirects
• Per-merchant data isolation — all queries scoped to merchant_id

🚀 Tech Stack

📦 What's Included

• Full Laravel 11 backend source code (REST API + Blade Web Dashboard)
• Full Flutter source code (Mobile + Web, Dart null-safe)
• Database migrations + seeders with demo data
• Full API documentation (docs/API.md)
• Automated VPS deployment scripts (Ubuntu + Nginx + MySQL + Let's Encrypt)
• Ready-to-use demo accounts for all roles
• Step-by-step README in English & Indonesian

• Multi-tenant SaaS — each merchant has fully isolated data 
• Laravel 11 REST API with Sanctum Bearer Token authentication 
• Flutter 3.10+ Mobile & Web app (single codebase) 
• Role-Based Access Control: super_admin / merchant_owner / merchant_staff 
• Subscription gating — expired accounts blocked with 402, Flutter auto-redirects 
• 3-factor pricing matrix: Service Type × Duration × Unit 
• Order workflow: pending → processing → ready_for_pickup → completed → picked_up 
• WhatsApp one-tap notification on every order status update 
• Bluetooth thermal printer receipt printing 
• PDF receipt & report generation and sharing 
• Daily & monthly revenue reports with chart visualization 
• Multi-user per merchant with Owner / Staff roles 
• Super Admin web dashboard (Laravel Blade + Tailwind CSS) 
• Subscription packages configurable from admin — no code changes needed 
• Built-in marketing landing page with pricing section 
• Automated VPS deployment script (Ubuntu + Nginx + MySQL + SSL) 
• Multi-language: Indonesian & English (Flutter ARB i18n) 
• Full API documentation included

• PHP >= 8.2 & Composer 2.x 
• PHP extensions: pdo_sqlite, mbstring, openssl, tokenizer, xml, ctype, json, bcmath 
• MySQL 8+ (production) — SQLite included for local dev 
• Flutter SDK >= 3.10.3 & Dart >= 3.10.3 
• Android Studio or Xcode (for mobile builds) 
• Chrome browser (for Flutter Web) 
• Ubuntu 20.04+ VPS (for server deployment)

Backend Setup

1. Run composer install inside the backend/ folder 
2. Copy .env.example to .env and run php artisan key:generate 
3. Run php artisan migrate --seed to create tables and demo data 
4. Start server: php artisan serve --host=0.0.0.0 --port=8000 
5. Open web dashboard at http://localhost:8000/admin

Flutter App Setup

1. Run flutter pub get inside the frontend/ folder 
2. Edit lib/core/constants/api_constants.dart — set baseUrl to your server IP 
3. Run flutter run (device/emulator) or flutter run -d chrome (web) 
4. Build APK: flutter build apk --release

VPS Deployment 

1. Upload deploy/setup-vps.sh to your Ubuntu server 
2. Run bash setup-vps.sh — auto-installs PHP, Nginx, MySQL, SSL