https://github.com/royhridoy/haven-hopper
Haven Hopper is a rental application that allows users to browse, search, and book rentals. It includes role-based access control for admins, hosts (rental owners), and users. The platform supports multiple payment methods and host applications.
https://github.com/royhridoy/haven-hopper
admin-dashboard booking-system filamentphp host-dashboard inertiajs laravel multi-user mysql open-source php property-management rental-app role-based-auth stripe-integration tailwindcss vuejs
Last synced: 8 months ago
JSON representation
Haven Hopper is a rental application that allows users to browse, search, and book rentals. It includes role-based access control for admins, hosts (rental owners), and users. The platform supports multiple payment methods and host applications.
- Host: GitHub
- URL: https://github.com/royhridoy/haven-hopper
- Owner: RoyHridoy
- Created: 2025-01-15T04:08:38.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-02-01T17:03:14.000Z (8 months ago)
- Last Synced: 2025-02-10T19:18:28.155Z (8 months ago)
- Topics: admin-dashboard, booking-system, filamentphp, host-dashboard, inertiajs, laravel, multi-user, mysql, open-source, php, property-management, rental-app, role-based-auth, stripe-integration, tailwindcss, vuejs
- Language: PHP
- Homepage: http://ic.misbah.co/
- Size: 1.41 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Haven Hopper
## Overview
Haven Hopper is a rental application that allows users to browse, search, and book rentals. It includes role-based access control for admins, hosts (rental owners), and users. The platform supports multiple payment methods and host applications.
## 📦 Technologies Used
- **Backend**: Laravel 11
- **Frontend**: Vue.js, Inertia.js, TailwindCSS
- **Admin Panel**: FilamentPHP 3
- **Database**: MySQL
- **Payment Integration**: Stripe
---
## 🔑 User Roles & Permissions
### 1. Admin
- Approves/rejects rental listings.
- Approves/rejects host applications.
- Manages all data.
- Creates and manages amenities.
- Manages locations.
- Checks activity logs.
### 2. Host (Rental Owner)
- Can create and manage rental listings.
- Can approve cash payment bookings.
### 3. User
- Can browse and search rentals.
- Must register and log in to book rentals.
- Can apply to become a host.
### 4. Visitor
- Can browse and search available rentals.
- Cannot book rentals without registration.
---
## 📌 Features
### 1. Rental Management
- Hosts can create rentals.
- Rentals require admin approval before appearing on the homepage.
### 2. Booking System
- Users can book rentals.
- Payment methods:
- **Cash**: Requires host approval.
- **Stripe**: No manual approval required.
### 3. Host Application Process
- Users register first and verify their email.
- Users can apply to become a host by submitting a form.
- Admins can approve or reject host applications.
### 4. Search & Filtering
- Visitors and users can search rentals based on:
- Category
- Location
- Total guests
- Available dates
### 5. Authentication & Authorization
- Users must register and log in to book rentals.
- Email verification is required before applying as a host.
- Admins manage all approvals and data.
### 6. Admin Panel Enhancements
- Admins can create and manage **amenities**.
- Admins can manage **locations**.
- Admins can **check activity logs** for tracking actions.
---
## 💻 Installation Guide
### Prerequisites
- PHP 8.2+
- Composer
- Node.js & npm
- MySQL or any other configured database
### Setup Steps
1. Clone the repository:
```sh
git clone https://github.com/RoyHridoy/haven-hopper.git
cd haven-hopper
```
2. Install dependencies:
```bash
composer install
npm install && npm run build
```
3. Set up environment variables:
```bash
cp .env.example .env
php artisan key:generate
```
- Configure database credentials in `.env`.
4. Run migrations and seed data:
```bash
php artisan migrate --seed
```
5. Set up storage
```bash
php artisan storage:link
```
6. Configure mail client from `.env`
7. Start the development server:
```bash
php artisan serve
npm run dev
```
---
## 📈 Some Endpoints
### Authentication
- `POST /register` - Register a new user.
- `POST /login` - Authenticate user.
- `POST /logout` - Log out user.
### Rentals
- `GET /rentals` - List all rentals.
- `GET /rentals/{id}` - Get rental details.
### Booking
- `POST /bookings` - Create a booking.
- `GET /bookings` - List user bookings.
### Host Actions
- `GET /host` - Host Dashboard.
### Admin Actions
- `GET /admin` - Admin Dashboard.
### All Endpoints
```bash
php artisan route:list --except-vendor
```
---
## 🚀 Deployment
- Configure `.env` for production.
- Use `php artisan config:cache` for optimized configuration.
- Set up a queue worker for background jobs:
```bash
php artisan queue:work
```
---
## 🤝 Contribution
We welcome contributions! Follow these steps to contribute:
1. Fork the repository.
2. Create a new feature branch.
3. Make your changes and commit them.
4. Run Following commands before give a PR
1. Run Static Analysis Tool to check you have no error. To maintain codebase we use [**Larastan**](https://github.com/larastan/larastan) **level 6**.
```bash
composer analyse
```
2. After running, if you faced any error, fix them.
3. You have to ensure that you write tests for every feature you build. Check all tests are ok
```bash
php artisan test
```
4. Make sure all the cases are ok to give a PR.
5. Push your changes to your forked repository.
6. Open a pull request with a detailed description. For visual changes, provide screenshot
---
## ✅ License
Haven Hopper is open-source and available under the MIT License.
---