☰

Japanese Host Family Platform

Live SiteGitHub
Japanese Host Family Platform Screenshot

Website Summary

This is a marketplace application connecting Japanese host families with international guests seeking accommodation in Japan. It facilitates homestay arrangements, offering an immersive cultural and language experience for visitors.

Technical Overview

This project demonstrates comprehensive full-stack development capabilities, encompassing frontend UI/UX, backend API development, database design, authentication, and performance optimization.

Architecture & Stack

  • Frontend: React 18, TypeScript, Vite, React Query, Context API, shadcn/ui, Tailwind CSS, React Router v6
  • Backend: Supabase (PostgreSQL, Auth, Storage), Serverless Architecture
  • Database: PostgreSQL via Supabase (See diagram below)
  • Real-time: WebSocket integration via Supabase
  • Internationalization: i18next

Core Features

  • Dual user roles (Hosts, Guests) with distinct functionalities.
  • Comprehensive listing management for hosts.
  • Advanced search, filtering, and map-based discovery for guests.
  • Real-time messaging system between users.
  • Detailed user profiles with rating/review system.
  • Full bilingual support (English/Japanese).
  • Secure authentication (email/password, social login, password reset).

Key Implementation Details

  • Type-safe data flow using shared TypeScript interfaces.
  • Custom React hooks for business logic (useAuth, useLanguage, useConversation).
  • Responsive layouts adapting from mobile to desktop.
  • Data-driven UI components with loading, error, and success states.
  • Optimized image loading and code splitting for performance.
  • Row-level security in Supabase and secure API endpoints.