Appointment Booking System

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 | admin@example.com | password | | Staff | amaka@example.com | password | | Staff | chidi@example.com | password | | Client | user@example.com | password |

Features

- 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

Requirements

- 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

Instructions

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 admin@example.com / 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)