Tiny House Rentals Online Marketplace Development

Building a Tiny House Bookings Marketplace This briefing serves as a complete technical guide for freelancers building a professional platform similar to Natuurhuisje, Airbnb, [login to view URL], or [login to view URL], focused on tiny houses. Target audience: Full stack developers, frontend developers, backend developers, UX/UI designers, and DevOps engineers. 1. PLATFORM GOAL An online marketplace where landlords can offer tiny houses and renters can search, book, and pay safely. Important: • Strong focus on user-friendliness, SEO, reliable bookings, and clean architecture. • Scalable from MVP to full-fledged platform. 2. OVERVIEW OF THE RECOMMENDED TECH STACK Frontend • [login to view URL] (React) o SEO-ready, server-side rendering, fast o Recommended hosting: Vercel Backend API Two equivalent options: 1. Python – Django + Django REST Framework 2. Node.js o SEO-ready, server-side rendering, fast o Recommended hosting: Vercel Backend API Two equivalent options: 1. Python – Django + Django REST Framework 2. Node.js – NestJS Database • PostgreSQL (relational, ideal for bookings) • Redis (caching and availability calculations) Payments • Stripe Connect (Standard or Express) o Split payments o Identity checks Payout flows Authentication • JWT tokens via backend, or • Auth0 / Supabase Auth Hosting / Cloud • Frontend: Vercel • Backend: AWS, Render or DigitalOcean • Database: AWS RDS PostgreSQL / DigitalOcean Managed PG Mobile apps (phase 2) • React Native — 1 codebase: iOS + Android 3. FUNCTIONALITIES (PER MVP AND FULL-FEATURED PHASE) 3.1 MVP — MUST HAVES These must be developed in phase 1. 1. Landing page & search experience • Search filters: date, location (map/basic), number of people • SEO-friendly URLs 2. Listing detail page • Photo gallery • Amenities, location, max persons • Price calculation based on dates • Calendar sync visible 3. Booking module • Check-in / check-out • Live price update • Stripe payment • Automatic emails (confirmation, invoice) 4. Host Dashboard (MVP) • Create & manage listings • Manage calendar • Price per night / weekend / week • View reservations 5. User Dashboard (MVP) • Reservation overview • Profile settings • Cancel / modify if allowed 6. Admin Panel • Host management • User management • Bookings management • Content moderation 3.2 Extensive Features — FULL-FLEDGED PLATFORM 1. Review System • 1–5 stars + text • Optional: host can also review tenant 2. Advanced Search & Filters • Map view (Leaflet or Mapbox) • Filters: sauna, hot tub, eco, forest, water, wifi, etc. 3. Dynamic Pricing • Weekend rates • High season • Adjustable rules 4. Messaging System • Real-time chat (WebSockets / [login to view URL]) • Push notifications 5. Multilingual • NL / FR / DE / EN via [login to view URL] i18n routing 6. iCal Sync with Airbnb / Booking • Automatic calendar import/export 4. ARCHITECTURE DIAGRAM (HIGH LEVEL) [ [login to view URL] Frontend ] ---> [ API Gateway / Backend (Django/NestJS) ] [PostgreSQL] [Redis] [Stripe] [Background Workers / Celery / BullMQ] [Email Provider] 5. DATABASE MODEL (BASICS) Table Overview 1. Users 2. Hosts (subset of users) 3. Listings 4. ListingPhotos 5. ListingsAmenities 6. AvailabilityCalendars 7. Bookings 8. Payments 9. Reviews 10. Messages (if chat) Example (simplified structure) Users - id - name - email - phone - role (user/host/admin) - created_at Listings - id - host_id (FK Users) - title - description - price_per_night - location_lat - location_lng - max_guests - created_at Bookings - id - user_id (FK Users) - listing_id (FK Listings) - check_in - check_out - total_price - payment_status - created_at Payments - id - booking_id - stripe_payment_intent - amount - payout_status - created_at 6. EMAILS & AUTOMATION Via SendGrid / Mailgun / AWS SES Automatic emails: • Booking confirmed • Booking cancelled • New booking for hosts • Password reset • Welcome email 7. SECURITY & PRIVACY • HTTPS everywhere • SSL certificates via Vercel/Cloudflare • JWT + refresh tokens • Rate limiting (DDoS protection) • Stripe PCI compliance for payments • GDPR ready: data minimization, data exports, data deletion 8. TESTING & QA • Unit tests for backend (PyTest / Jest) • API tests (Postman collection) • E2E tests (Playwright / Cypress) • UAT (user acceptance testing) for release 9. ROADMAP & PHASES Phase 1 — MVP (10–14 weeks) 1. UX/UI design 2. Database setup 3. Backend API (bookings + payments) 4. Frontend (search, detail, booking) 5. Host dashboard 6. Admin panel (basic) 7. Stripe integration 8. Deployment + security checks Phase 2 — Optimization (4–8 weeks) • Reviews • iCal sync • Multilingual support • Marketing pages + SEO Phase 3 — Mobile apps (6–10 weeks) • React Native app • Push notifications • App store deployment 10. EXTRA CONDITIONS FOR FREELANCERS • Code must be on GitHub • Code must be fully documented • No vendor lock-in / proper architecture • 1-week sprints with demos • Transparent communication and achievable planning

Projektin tunnus (ID): 40220382