https://github.com/rsn601kri/wanderlust
An Airbnb-style booking site that allows users to browse, filter, and book listings. It provides a seamless experience with powerful search filters, a user-friendly UI, and a robust backend.
https://github.com/rsn601kri/wanderlust
airbnb api development hackathon ui web
Last synced: about 2 months ago
JSON representation
An Airbnb-style booking site that allows users to browse, filter, and book listings. It provides a seamless experience with powerful search filters, a user-friendly UI, and a robust backend.
- Host: GitHub
- URL: https://github.com/rsn601kri/wanderlust
- Owner: RSN601KRI
- Created: 2025-03-29T13:06:24.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-03-29T13:12:43.000Z (about 1 year ago)
- Last Synced: 2025-03-29T14:24:14.113Z (about 1 year ago)
- Topics: airbnb, api, development, hackathon, ui, web
- Language: TypeScript
- Homepage: https://wanderlust-rouge.vercel.app/
- Size: 52.7 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Airbnb-Style Booking Site
## 🚀 Overview
This project is an **Airbnb-style booking site** that allows users to browse, filter, and book listings. It provides a seamless experience with powerful search filters, a user-friendly UI, and a robust backend.
## 🏗 Features
- 🔍 **Search & Filters**: Filter listings by location, price, amenities, and availability.
- 🏠 **Listing Management**: View detailed property listings with images and descriptions.
- 👤 **User Authentication**: Sign up, log in, and manage bookings.
- 💳 **Payment Integration**: Secure payment processing.
- 📅 **Booking System**: Reserve properties with real-time availability updates.
- 📍 **Map Integration**: View listings on an interactive map.
## 🛠 Tech Stack
- **Frontend**: React, Next.js, Tailwind CSS
- **Backend**: Node.js, Express, MongoDB
- **Authentication**: Firebase/Auth0
- **Payments**: Stripe
- **Hosting**: Vercel/Netlify for frontend, AWS/DigitalOcean for backend
## 🏁 Getting Started
### Prerequisites
Ensure you have the following installed:
- Node.js
- MongoDB
- Git
### Installation
```bash
# Clone the repository
git clone https://github.com/your-username/airbnb-style-booking-site.git
cd airbnb-style-booking-site
# Install dependencies
npm install
# Configure environment variables
cp .env.example .env
# Update .env with your database and API keys
# Start the development server
npm run dev
```
### Running the Backend
```bash
cd backend
npm install
npm start
```
## 📌 Usage
- **Browse Listings**: Search properties and apply filters.
- **Create an Account**: Sign up to save favorite listings and make bookings.
- **Book a Stay**: Select dates and confirm your booking with secure payment.
- **Manage Listings**: Hosts can add, update, and remove properties.
## 🛠 API Endpoints
| Method | Endpoint | Description |
|--------|---------|-------------|
| GET | `/api/listings` | Fetch all listings |
| GET | `/api/listings/:id` | Fetch a single listing |
| POST | `/api/bookings` | Create a booking |
| GET | `/api/bookings/:userId` | Get user bookings |
## 🎨 UI Screenshots
*(Add images of UI components such as homepage, search results, booking page, etc.)*
## 📜 License
This project is licensed under the MIT License.
## 🤝 Contributing
Pull requests are welcome! For major changes, please open an issue first.