Luxe — Premium Companion Directory Platform

Enterprise-grade React frontend built for scale, performance, and premium UX.

Tech Stack

• React 19 + TypeScript + Vite
• Material UI v7 (custom luxury theme)
• TanStack Query · Zustand · React Hook Form · Zod
• Framer Motion · i18next · React Helmet Async
• PWA-ready with service worker

Getting Started

npm install
cp .env.example .env
npm run dev

Open http://localhost:5173.

Scripts

Command	Description
npm run dev	Start development server
npm run build	Production build
npm run preview	Preview production build
npm run lint	Run ESLint

Architecture

src/
├── app/           # App shell, providers, router
├── components/    # Shared UI (design system, layouts, search)
├── features/      # Feature modules (home sections, etc.)
├── pages/         # Route-level page components
├── layouts/       # Main, Auth, Dashboard layouts
├── theme/         # MUI theme, design tokens
├── store/         # Zustand stores
├── hooks/         # Custom React hooks
├── api/           # Axios client & interceptors
├── services/      # API service layer
├── validators/    # Zod schemas
├── types/         # TypeScript definitions
├── constants/     # App constants & mock data
├── config/        # i18n, env config
├── utils/         # Utility functions
└── styles/        # Global CSS

Phase 1 (Complete)

• Enterprise folder structure
• Luxury design system (dark/light/auto themes)
• Responsive header with mobile drawer
• Global search with recent queries
• Premium landing page (all sections)
• Auth layout (login, register, forgot password)
• SEO metadata & structured data
• PWA manifest

Phases Roadmap

• Phase 2 — User-facing pages (profiles, cities, categories, blog)
• Phase 3 — Advertiser dashboard
• Phase 4 — Admin dashboard
• Phase 5 — Blog & forum
• Phase 6 — Wallet, ads, notifications, verification, analytics

License

Private — All rights reserved.