Salon Booking Management System With Mobile App using Flutter

✨ Key Features

• Online Appointments: Time-slot picker, service combos, add-ons, stylist selection, and buffer times.
• Smart Scheduling: Staff calendars, roster/shift planning, break times, overbooking rules, and blackout dates.
• Customer Mobile App (Flutter): Browse services, book/reschedule/cancel, pay deposits, track history, and rate services.
• Staff App (Flutter): Today’s schedule, upcoming customers, notes/contraindications, clock-in/out (optional geofence).
• POS & Checkout: Cart with services + retail items, tips, taxes, coupons, partial payments, and printed/emailed receipts.
• No-Show & Late Policies: Deposits, cancellation windows, auto-fee posting, and friendly reminder flows.
• Payments: Stripe/PayPal-ready (adapters), cash, and local gateways via provider plugins; deposits & full prepay.
• Notifications: Email/SMS/Push reminders, confirmations, follow-ups, and review requests with templates.
• Inventory & Retail: Products, stock alerts, supplier pricing, barcode/QR support, and sales reports.
• Memberships & Loyalty: Packages, credit bundles, points/tiers, birthday perks, and referral codes.
• Multi-Branch: Branch calendars, staff assignment per location, branch-level price lists, and user roles.
• Reports & Analytics: Revenue by service/staff/branch, utilization, rebook rate, no-show %, product margins, and exports (CSV/XLS).
• Marketing Tools: Promo codes, service bundles, abandoned booking nudges, and simple campaign blasts.
• Accessibility & Localization: Multi-language, multiple currencies, RTL, and timezone-aware timestamps.
• Security & Roles: RBAC for owner/manager/receptionist/stylist; audit logs; optional 2FA.

⚙️ Technical Stack

• Mobile: Flutter 3.x (Android/iOS), REST/JSON client, push via Firebase Cloud Messaging (FCM).
• Backend: PHP 8.x (Laravel) – routing, policies, queues, notifications, storage.
• Web Admin: Blade/Tailwind (or Bootstrap) with role-based access and responsive layout.
• Database: MySQL/MariaDB (InnoDB, UTF-8MB4).
• Cache & Queue: Redis for sessions, jobs (reminders, push, reports), and rate limits.
• Payments: Provider adapters (Stripe/PayPal/local); webhook signature verification.
• Server Requirements: Nginx/Apache; PHP extensions: pdo_mysql, mbstring, openssl, json, xml, ctype, curl, zip.
• Build Tooling: Composer, Node.js (Vite) for admin assets; Flutter SDK/Xcode/Android Studio for mobile.

🧩 Installation Guide

1. Backend Setup: Upload backend → composer install --no-dev → copy .env.example to .env → set APP_URL, DB, mail (SMTP), cache/queue, and payment keys → php artisan key:generate → php artisan storage:link.
2. Database Init: Run php artisan migrate --seed to create tables and demo data (services, roles, sample branch).
3. Scheduler & Workers: Cron * * * * * php artisan schedule:run and start php artisan queue:work for reminders/notifications.
4. Push & Auth: Set Firebase credentials (server key) for FCM; configure email/SMS gateways if used.
5. Mobile Apps: Open the Flutter project(s) → set API base URL in lib/config.dart (or .env) → flutter pub get → flutter run (dev) → flutter build apk/ipa for release.
6. Branding: Update app name, icons, splash assets, and store listings; set policies (deposits, cancellation windows) in admin.
7. Go Live: Point domain to public/, enable HTTPS, add HSTS/CSP headers, and verify payment webhooks end-to-end.

📦 Deliverables

• Flutter mobile source (client & staff apps) with localization files.
• Laravel backend source (API, admin panel, notifications, webhooks).
• SQL migrations & seeders (services, roles, sample branch & staff).
• Email/SMS/push templates and scheduler/queue configs.
• Sample .env.example files (backend & mobile configs).
• Documentation: quick-start, deployment, and customization notes.

📱 Supported Platforms

• Android: 7.0+ (SDK 24+)
• iOS: 13+ (Xcode build required)
• Web Admin: Chrome, Firefox, Safari, Edge (current versions)
• Server OS: Ubuntu/Debian/CentOS recommended; Windows Server compatible

🧠 Notes

• License: Distributed under the GPL for lawful use, study, modification, and redistribution in line with GPL terms.
• Customization Tips: Keep pricing/policies in admin settings; use provider adapters for payments/SMS; add custom fields (contraindications, patch tests) via migrations.
• Security: Enforce HTTPS; verify webhook signatures; rate-limit booking endpoints; restrict file types for media uploads; enable RBAC & optional 2FA.
• Performance: OPcache + Redis; image thumbnails; paginate reports; precompute peak-hour availability.
• SEO Assurance: Public landing/booking pages include meta fields and schema hooks; private admin/mobile APIs are noindex.

👨‍💻 Original Developer Credit

We acknowledge the original developer and marketplace publisher as the authoritative source for the product’s concept and features.
For provenance and official updates, please consult the original listing on
CodeCanyon (or the developer’s official site).

🔒 Disclaimer

This is a GPL redistribution created for learning, testing, and compliant use under the GPL. We are not the original authors and do not claim endorsement or affiliation.
All trademarks remain the property of their respective owners. Before production, verify third-party dependency licenses, configure payment/KYC requirements for your region, and conduct security & performance reviews.