BookingApp is a complete, production-ready appointment booking system built with Laravel 11+. It ships with everything you need to run a professional booking business — from a beautiful dark glass UI to 8 integrated payment gateways with a single admin toggle to enable or disable any of them.

Whether you run a clinic, salon, consultancy, spa, legal office, or any service-based business, BookingApp is built to go live fast.

─────────────────────────────────────────
CORE BOOKING FEATURES
─────────────────────────────────────────

- Public service listing with category filtering and live slot availability
- Smart time slot engine — respects working hours, break times, and existing bookings
- Step-by-step booking form — choose specialist, date, time slot, and add notes
- Appointment statuses: Pending → Confirmed → Completed / Cancelled / No-Show
- Soft deletes on all records — nothing is permanently lost
- Booking confirmation codes for reference
- 24-hour and 2-hour automated email reminders

─────────────────────────────────────────
PAYMENT GATEWAYS (8 TOTAL)
─────────────────────────────────────────

All gateways are toggleable ON/OFF from the admin panel with a single click. API credentials are stored encrypted in the database — no code changes needed.

- Paystack — Cards, Bank Transfer, USSD (Nigeria)
- Flutterwave — Cards, Mobile Money (Africa)
- Monnify — Bank Transfer, Card (Nigeria)
- Stripe — International Cards (Global)
- PayPal — PayPal Account (Global)
- NOWPayments — 100+ Cryptocurrencies (Global)
- Bitnank — BTC, ETH, USDT, LTC, BNB (Global)
- Manual / Bank Transfer — Proof upload with admin approve/reject workflow

─────────────────────────────────────────
ADMIN PANEL
─────────────────────────────────────────

- Full dashboard with revenue charts, daily stats, and upcoming appointments
- Manage all appointments — confirm, complete, cancel, reschedule, delete
- Service management — create/edit with price, duration, color, category, and staff assignment
- Staff management — profiles, weekly schedules, break times, service assignments
- Gateway Settings — enable/disable each gateway, toggle test/live mode, set currency per gateway
- Transaction records — filter by status, gateway, date; approve manual payments; refresh crypto status
- Global Settings — change app name, timezone, slot interval, advance booking window
- Dynamic currency system — change your business currency from the admin panel (22 currencies supported). Symbol and code update everywhere instantly — service prices, checkout, receipts, charts

─────────────────────────────────────────
MULTI-ROLE ACCESS
─────────────────────────────────────────

- Admin — full platform control
- Staff — view own schedule, confirm/complete/no-show appointments
- Client — register, book, pay, manage own appointments

─────────────────────────────────────────
EMAIL NOTIFICATIONS
─────────────────────────────────────────

All emails are queued for non-blocking delivery:
- Booking received confirmation
- Appointment confirmed
- Appointment cancelled
- Appointment rescheduled
- Payment confirmed (receipt)
- Manual payment received (client + admin)
- Manual payment approved
- 24h and 2h appointment reminders

─────────────────────────────────────────
TECHNICAL HIGHLIGHTS
─────────────────────────────────────────

- Laravel 11 with PHP 8.2
- Dark glass UI design system — glassmorphism cards, animated gradient orbs, responsive layout
- Mobile-responsive with hamburger sidebar on admin panel
- Rate limiting on payment endpoints (anti-spam)
- Webhook signature verification for Paystack, Flutterwave, Stripe, NOWPayments
- Automatic currency conversion (NGN ↔ USD/EUR/GBP) via live exchange rate API with fallback
- Private disk for payment proof files — served via secure admin-only route
- Full test suite — Feature and Unit tests with in-memory SQLite
- Supervisor config, Nginx config, and one-command deploy script included
- Complete setup guide from VPS provisioning to SSL certificate

─────────────────────────────────────────
SUPPORTED CURRENCIES (22)
─────────────────────────────────────────

NGN, USD, EUR, GBP, GHS, KES, ZAR, CAD, AUD, INR, EGP, XOF, MAD, TZS, UGX, AED, SAR, BRL, MXN, JPY, CNY, SGD

Demo Login : 

| Role | Email | Password |
|------|-------|----------|
| Admin | [email protected] | password |
| Staff | [email protected] | password |
| Staff | [email protected] | password |
| Client | [email protected] | password |

- 8 payment gateways with admin on/off toggle (Paystack, Flutterwave, Monnify, Stripe, PayPal, NOWPayments, Bitnank, Manual)
- Dynamic currency system — 22 currencies, changeable from admin panel anytime
- Dark glass UI with glassmorphism cards, gradient orbs, and smooth animations
- Smart availability engine — working hours, breaks, conflict detection
- Multi-role access — Admin, Staff, Client
- Manual bank transfer with proof upload and admin approve/reject workflow
- Crypto payments via Bitnank and NOWPayments with webhook verification
- Queued email notifications for every booking and payment event
- Automated 24h and 2h appointment reminder emails
- Complete VPS deployment guide — Nginx, SSL, Supervisor, cron scheduler

- PHP 8.2 or higher
- Laravel 11.44 or higher
- MySQL 8.0+ or PostgreSQL 14+
- Composer 2.x
- Node.js 18+ (for frontend assets)
- Supervisor (for queue workers in production)
- SMTP credentials for email delivery (Mailgun, Gmail, etc.)
- API keys from whichever payment gateways you want to enable

1. Create a fresh Laravel 11 project: composer create-project laravel/laravel bookingapp
2. Copy all files from the zip into the project directory
3. Delete the 3 default Laravel migrations (users, cache, jobs tables) — the zip includes correct replacements
4. Run: composer install
5. Copy .env.example to .env and set your DB_*, MAIL_*, and APP_URL values
6. Run: php artisan key:generate
7. Run: php artisan migrate --seed
8. Run: php artisan storage:link
9. Start the server: php artisan serve
10. Login at /admin/dashboard with [email protected] / password
11. Go to Admin → Payments → Gateway Settings to enable payment methods and enter API keys
12. Go to Admin → Settings to set your currency and app name
13. Full VPS production setup instructions are included in README.md (Nginx, SSL, Supervisor, cron)