🏠 Airbnb Full Clone

A production-ready full-stack Airbnb clone built with modern technologies and best practices.

🎯 Features

Backend (NestJS)

✅ 33 REST API Endpoints fully functional
🔐 JWT Authentication with role-based access (Guest/Host)
💳 Stripe Payment Integration with webhooks
🏠 Property Management (CRUD, publish/unpublish)
📅 Booking System with status management
⭐ Review System with ratings
❤️ Favorites/Wishlist functionality
📊 Prisma ORM with SQLite/PostgreSQL support
🛡️ Input Validation with class-validator
🔄 Error Handling with proper HTTP status codes

Frontend (Next.js 15)

⚡ App Router with server components
🎨 shadcn/ui + TailwindCSS for modern UI
📱 Responsive Design mobile-first approach
🔄 Zustand for state management
🪝 Custom Hooks for API integration
🎯 TypeScript end-to-end type safety
🌐 SEO Optimized with meta tags

🏗️ Architecture

airbnb-full-clone/
├── apps/
│   ├── api-gateway/         # NestJS Backend
│   │   ├── src/
│   │   │   ├── auth/        # Authentication module
│   │   │   ├── properties/  # Property management
│   │   │   ├── bookings/    # Booking system
│   │   │   ├── payments/    # Stripe integration
│   │   │   ├── reviews/     # Review system
│   │   │   ├── favorites/   # Wishlist functionality
│   │   │   └── common/      # Shared utilities
│   │   └── test/            # API tests
│   │
│   └── web/                 # Next.js Frontend
│       ├── src/
│       │   ├── app/         # App router pages
│       │   ├── components/  # React components
│       │   ├── lib/         # Utilities & API clients
│       │   └── types/       # TypeScript types
│
└── packages/
    └── database/            # Prisma schema & migrations
        └── prisma/

🚀 Tech Stack

Backend

Framework: NestJS 10
Language: TypeScript 5
Database: Prisma ORM (SQLite/PostgreSQL)
Authentication: JWT with Passport
Payments: Stripe API
Validation: class-validator, class-transformer
Documentation: REST API with 33 endpoints

Frontend

Framework: Next.js 15 (App Router)
Language: TypeScript 5
Styling: TailwindCSS + shadcn/ui
State: Zustand
Forms: React Hook Form + Zod
HTTP Client: Axios
UI Components: Radix UI + shadcn/ui

📦 Installation

Prerequisites

Node.js 18+
pnpm 8+

Clone & Install

git clone https://github.com/YOUR_USERNAME/airbnb-fullstack-clone.git
cd airbnb-fullstack-clone
pnpm install

Setup Database

cd packages/database
npx prisma generate
npx prisma migrate dev --name init

Environment Variables

Backend (apps/api-gateway/.env):

DATABASE_URL="file:../../packages/database/prisma/dev.db"
JWT_SECRET=your_jwt_secret_key
STRIPE_SECRET_KEY=sk_test_...
STRIPE_PUBLISHABLE_KEY=pk_test_...
STRIPE_WEBHOOK_SECRET=whsec_...

Frontend (apps/web/.env.local):

NEXT_PUBLIC_API_URL=http://localhost:3001/api
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_...

🏃 Running the Project

Development Mode

Backend:

cd apps/api-gateway
pnpm run start:dev
# Server runs on http://localhost:3001

Frontend:

cd apps/web
pnpm run dev
# App runs on http://localhost:3000

Production Build

# Backend
cd apps/api-gateway
pnpm run build
pnpm run start:prod

# Frontend
cd apps/web
pnpm run build
pnpm run start

📡 API Endpoints

Authentication

POST /api/auth/register - Register new user
POST /api/auth/login - Login user
GET /api/auth/me - Get current user

Properties

GET /api/properties - List all properties
GET /api/properties/:id - Get property details
POST /api/properties - Create property (Host only)
PATCH /api/properties/:id - Update property
DELETE /api/properties/:id - Delete property
PATCH /api/properties/:id/publish - Publish property
GET /api/properties/my-properties - Get my properties

Bookings

POST /api/bookings - Create booking
GET /api/bookings/my-bookings - Get my bookings
GET /api/bookings/host-bookings - Get bookings (Host)
GET /api/bookings/:id - Get booking details
PATCH /api/bookings/:id/confirm - Confirm booking (Host)
PATCH /api/bookings/:id/cancel - Cancel booking

Payments

POST /api/payments/create-intent - Create payment intent
POST /api/payments/confirm - Confirm payment
GET /api/payments/booking/:id - Get payment by booking
POST /api/payments/:id/refund - Refund payment
POST /api/payments/webhook - Stripe webhook

Reviews

POST /api/reviews - Create review
GET /api/reviews/property/:id - Get property reviews
GET /api/reviews/my-reviews - Get my reviews
GET /api/reviews/:id - Get review details
PATCH /api/reviews/:id - Update review
DELETE /api/reviews/:id - Delete review

Favorites

POST /api/favorites/:propertyId - Add to favorites
DELETE /api/favorites/:propertyId - Remove from favorites
POST /api/favorites/toggle/:propertyId - Toggle favorite
GET /api/favorites - Get my favorites
GET /api/favorites/check/:propertyId - Check if favorited
GET /api/favorites/count/:propertyId - Get favorite count

🧪 Testing

API Testing

# Use REST Client extension in VS Code
# Open apps/api-gateway/test/complete-test.http

📊 Database Schema

model User {
  id        String   @id @default(cuid())
  email     String   @unique
  password  String
  name      String
  role      Role     @default(GUEST)
  avatar    String?
  createdAt DateTime @default(now())
  updatedAt DateTime @updatedAt
}

model Property {
  id           String   @id @default(cuid())
  title        String
  description  String
  price        Float
  propertyType PropertyType
  maxGuests    Int
  bedrooms     Int
  bathrooms    Int
  city         String
  country      String
  images       String   // JSON array
  status       PropertyStatus @default(DRAFT)
  hostId       String
  host         User     @relation(fields: [hostId])
}

model Booking {
  id          String   @id @default(cuid())
  propertyId  String
  guestId     String
  checkIn     DateTime
  checkOut    DateTime
  guests      Int
  totalPrice  Float
  status      BookingStatus @default(PENDING)
}

model Payment {
  id                     String   @id @default(cuid())
  bookingId              String   @unique
  amount                 Float
  stripePaymentIntentId  String
  status                 PaymentStatus @default(PENDING)
}

model Review {
  id         String   @id @default(cuid())
  bookingId  String   @unique
  propertyId String
  userId     String
  rating     Int
  comment    String?
}

model Favorite {
  id         String   @id @default(cuid())
  userId     String
  propertyId String
  @@unique([userId, propertyId])
}

🎨 UI Components

Built with shadcn/ui:

Button, Input, Card, Dialog
Dropdown Menu, Avatar, Badge
Calendar, Select, Form
Toast notifications
Skeleton loaders
And more...

🚀 Deployment

Backend (Railway/Render)

cd apps/api-gateway
pnpm run build
# Deploy to Railway or Render

Frontend (Vercel)

cd apps/web
pnpm run build
# Deploy to Vercel

📝 License

MIT License - feel free to use this project for learning purposes.

👨‍💻 Author

Gherson

GitHub: [@YOUR_USERNAME]
LinkedIn: [Your LinkedIn]

🙏 Acknowledgments

Inspired by Airbnb
Built for learning and portfolio purposes
Not affiliated with Airbnb Inc.

📧 Contact

For questions or collaboration: your.email@example.com

⭐ If you found this project helpful, please give it a star!

Name		Name	Last commit message	Last commit date
.vscode		.vscode
apps		apps
docker/postgres		docker/postgres
packages		packages
.gitignore		.gitignore
.npmrc		.npmrc
LICENSE		LICENSE
README.md		README.md
docker-compose.yml		docker-compose.yml
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
pnpm-workspace.yaml		pnpm-workspace.yaml
turbo.json		turbo.json

Latest commit

History

Folders and files

Repository files navigation