MrZaKaRiAGit

Laravel Hotel

Laravel Hotel is an open-source web application built with laravel 8.0, enchanced with laravel reverb features to have realtime notification experience.

Created: 12/14/2025Last pushed: 10/21/2025
Laravel Hotel

Overview

Laravel Hotel is an open-source web application built with laravel 8.0, enchanced with laravel reverb features to have realtime notification experience.

Tags & Topics
View Source

Laravel Hotel

Laravel Hotel is an open-source web application built with laravel 8.0, enchanced with laravel reverb features to have realtime notification experience.

Its now compatible with laravel 12

🖼️ Screenshots

image image image

🚀 Installation

Prerequisites

  • PHP 8.2+
  • Composer
  • Node.js & NPM
  • MySQL/MariaDB

Database Setup

Create a new database:

mysql -u root -p
CREATE DATABASE hotel_app;
EXIT;

Installation Steps

  1. Clone & Configure
git clone https://github.com/WailanTirajoh/Laravel-Hotel.git
cd Laravel-Hotel
cp .env.example .env
  1. Install Dependencies
composer install
npm install
  1. Generate Assets
npm run build  # For production
# OR
npm run dev    # For development
  1. Setup Application
php artisan key:generate
php artisan migrate:fresh --seed
  1. Start Services
# Terminal 1: Application Server
php artisan serve

# Terminal 2: Reverb Server (for real-time notifications)
php artisan reverb:start

🔐 Demo Login

Access the admin dashboard with seeded demo accounts:

Note: Use the database seeders to create demo accounts, or check your .env file for configured test credentials.

🏗️ Architecture & Features

📊 Dashboard Modules

Dashboard

  • Real-time guest statistics with animated counters
  • Monthly charts with Chart.js integration
  • Today's guest overview with table design
  • Quick action buttons for common tasks
  • Welcome message with current date/time

Transaction Management

  • Complete reservation workflow with step-by-step process
  • Payment tracking with status badges
  • Down payment system (15% minimum)
  • Real-time email and push notifications
  • invoice generation

Customer Management

  • CRUD operations with forms
  • Advanced search and pagination
  • Customer profile pages with activity history
  • Avatar integration with fallback images
  • Relationship tracking with transactions

Room Management

  • Multi-level room management (Rooms, Types, Status, Facilities)
  • image galleries
  • Availability checking system
  • Capacity-based room recommendations
  • Status tracking with color-coded indicators

User Management (Super Admin Only)

  • Role-based access control (Super, Admin, Customer)
  • User activity logging with Spatie ActivityLog
  • user profiles
  • Permission management

🔔 Real-time Features

  • Reverb notifications for new reservations
  • Live dashboard updates
  • Push notifications for staff
  • Real-time payment status updates

📱 UI Components

Modern Navigation

  • Sleek sidebar with gradient background
  • Tooltip-enabled navigation icons
  • Dropdown menus with smooth animations
  • user profile dropdown

Enhanced Forms

  • Floating labels with smooth transitions
  • validation styling
  • Select2 integration for dropdowns
  • Date pickers with modern styling

Data Visualization

  • tables with hover effects
  • Chart.js integration for analytics
  • Progress bars and status indicators
  • badge system

🎨 Design System

Color Palette

  • Primary: #2563eb (Blue)
  • Success: #10b981 (Success Green)
  • Warning: #f59e0b (Warning Amber)
  • Danger: #ef4444 (Error Red)
  • Light: #f8fafc (Background Light)
  • Dark: #1e293b (Text Dark)

Typography

  • Primary Font: Inter (400, 500, 600, 700)
  • Fallback: Nunito, sans-serif
  • Size Scale: 0.875rem base with 1.6 line height

Components

  • Cards: 12px border radius with subtle shadows
  • Buttons: gradients with hover effects
  • Forms: Floating labels with focus states
  • Tables: Hover effects with styling

📋 Business Logic

Reservation Workflow

  1. Customer Registration: Admin creates/selects customer profile
  2. Room Selection: System recommends available rooms based on:
    • Date range availability
    • Guest capacity requirements
    • Room type preferences
  3. Confirmation: Review booking details and pricing
  4. Payment: Minimum 15% down payment required
  5. Check-in/Check-out: Status tracking throughout stay

Payment System

  • Down payment calculation (15% minimum)
  • Balance tracking and payment completion
  • invoice generation
  • Payment history with status indicators

Notification System

  • Real-time Reverb notifications
  • Email notifications for important events
  • Push notifications for mobile devices
  • Activity logging for audit trails

🗄️ Database Schema

ERD

Key Relationships

  • UsersCustomers (1:1)
  • CustomersTransactions (1:N)
  • RoomsTransactions (1:N)
  • TransactionsPayments (1:N)
  • RoomsTypes (N:1)
  • RoomsStatus (N:1)

🔧 Technical Stack

Backend

  • Laravel 12: Latest PHP framework
  • PHP 8.2+: Modern PHP features
  • MySQL: Reliable database system
  • Laravel Reverb: WebSocket server
  • Spatie Packages: Activity logging and more

Frontend

  • Bootstrap 5: Modern CSS framework
  • Font Awesome 6: icon set
  • Chart.js 4: Data visualization
  • Select2: Enhanced select dropdowns
  • DataTables: table management
  • SweetAlert2: Beautiful alerts and modals

Development Tools

  • Vite: Modern build tool
  • Sass: Advanced CSS preprocessing
  • Laravel Pint: Code formatting
  • PHPUnit: Testing framework

🤝 Contributing

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📄 License

This project is open-sourced software licensed under the MIT license.

👨‍💻 Developer

Wailan Tirajoh


🎯 Perfect for

  • Hotel and hospitality management
  • Learning Laravel development
  • dashboard implementations
  • Real-time web application examples
  • Modern UI/UX design patterns

Built with ❤️ using Laravel 12 and modern web technologies.

Repository Stats

Stars
0
Forks
0
Watchers
0
Size
10.4 MB
Issues0 Open

Gallery

Project screenshot 1
Project screenshot 2
Project screenshot 3
Project screenshot 4