https://github.com/tanvirulislm/maxhotel-project
MaxHotel is a hotel booking platform built with Laravel. It provides a foundation for managing bookings, customer data, and reservations. The project is actively evolving and serves as both a learning tool for Laravel and a customizable hotel management system.
https://github.com/tanvirulislm/maxhotel-project
booking-system hotel-management laravel open-source php8 web-application
Last synced: 28 days ago
JSON representation
MaxHotel is a hotel booking platform built with Laravel. It provides a foundation for managing bookings, customer data, and reservations. The project is actively evolving and serves as both a learning tool for Laravel and a customizable hotel management system.
- Host: GitHub
- URL: https://github.com/tanvirulislm/maxhotel-project
- Owner: tanvirulislm
- Created: 2024-12-02T20:15:26.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2024-12-02T20:52:42.000Z (5 months ago)
- Last Synced: 2025-01-31T21:18:14.344Z (3 months ago)
- Topics: booking-system, hotel-management, laravel, open-source, php8, web-application
- Language: CSS
- Homepage:
- Size: 31.6 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# **MaxHotel - Laravel-Based Hotel Website**
Welcome to **MaxHotel**, a modern hotel website designed to provide a seamless and user-friendly experience for customers and administrators alike. This project is built using **Laravel**, with a focus on clean architecture and incremental development to ensure quality and functionality.
---
## **🌟 Features (Current and Upcoming)**
### **Current**
- Blade templates for clean and reusable HTML structure.
- A responsive and visually appealing frontend design.
### **Planned Features**
- **Booking System:** Allow customers to book rooms with ease.
- **Customer Dashboard:** Manage personal bookings, preferences, and account details.
- **Admin Dashboard:** Enable administrators to oversee bookings, manage rooms, and handle customer inquiries.
---
## **🚀 Installation**
### **Prerequisites**
- PHP >= 8.1
- Composer
- MySQL or any preferred database
- Node.js (optional, for frontend assets)
### **Steps**
1. Clone this repository:
```bash
git clone https://github.com/tanvirulislm/maxhotel-project.git
2. Navigate to the project directory:
```
cd maxhotel-project
```
4. Install dependencies:
```
composer install
```
4. Set up the environment file:
```
cp .env.example .env
```
Update the `.env` file with your database credentials.
5. Generate the application key:
```
php artisan key:generate
```
7. Run migrations:
```
php artisan migrate
```
8. Serve the application:
```
php artisan serve
```
```
Visit http://localhost:8000 in your browser.
```
### **🛠️ Usage**
This repository serves as a foundation for a fully functional hotel booking platform. You can use it as-is for learning Laravel or customize it further to meet your project's requirements.
### **📖 Learning in Progress**
This project is a continuous learning journey. Each feature is added incrementally as I explore and master Laravel concepts. Here’s the roadmap:
### **Blade Templates ✅**
Booking System (Coming Soon)
Customer Dashboard (Planned)
Admin Dashboard (Planned)
Stay tuned for updates as the project evolves!
### **🤝 Contributions**
Contributions, suggestions, or feedback are welcome! Feel free to open an issue or submit a pull request.
### **📧 Contact**
If you have questions or want to connect, feel free to reach out:
- **Author**: Tanvirul Islam
- **GitHub**: [tanvirulislm](https://github.com/tanvirulislm)
- **Website**: [tanvirulislam.xyz](https://tanvirulislam.xyz)
### **📜 License**
This project is licensed under the MIT License.