lunar-marketplace

byAbhishek Rajyan

MASTER PROMPT — PREMIUM HOUSEHOLD SERVICES MARKETPLACE PLATFORM Create a modern, premium, scalable full-stack web platform for a household services marketplace where users can hire trusted professionals for home maintenance and repair services such as plumbers, electricians, cleaners, HVAC technicians, carpenters, painters, appliance repair technicians, landscapers, handymen, and emergency home services. The platform should feel like a combination of Uber + Airbnb + TaskRabbit with a cinematic premium SaaS design. --------------------------------------------------- BRAND STYLE --------------------------------------------------- Design Style: - Premium modern UI - Dark and light mode - Cinematic gradients - Smooth animations - Glassmorphism effects - Minimal but luxurious - Fully responsive - Professional enterprise dashboard style - 3D hover effects - Motion animations using Framer Motion Typography: - Modern sans-serif fonts - Clean spacing - Elegant card-based layouts Color Palette: - Black - White - Electric blue - Soft gray - Optional neon accent --------------------------------------------------- TECH STACK --------------------------------------------------- Frontend: - Next.js 15 - React - Tailwind CSS - Framer Motion - ShadCN UI Backend: - Node.js - NestJS or Express - PostgreSQL - Prisma ORM - Redis Authentication: - JWT - OAuth login - Google login - Phone OTP login - Two-factor authentication Infrastructure: - Docker - VPS deployment support - Cloudflare protection - CDN optimized Payments: - Stripe integration - PayPal integration - Wallet system - Escrow payments Maps & Tracking: - Google Maps API - Real-time worker tracking - Distance calculation - Route optimization Notifications: - Email notifications - SMS notifications - Push notifications - In-app notifications --------------------------------------------------- MAIN WEBSITE FEATURES --------------------------------------------------- 1. LANDING PAGE Create a cinematic homepage with: - Full-screen animated hero section - Service search bar - Animated service cards - Trust indicators - Customer testimonials - Statistics section - AI-powered service recommendation section - “Book a Professional in Minutes” CTA - Smooth scroll animations - Interactive service categories Sections: - Hero - Popular Services - How It Works - Top Rated Professionals - Emergency Services - Mobile App Showcase - Testimonials - FAQ - Footer --------------------------------------------------- 2. USER SYSTEM --------------------------------------------------- User Features: - User registration/login - Social login - Profile management - Saved addresses - Booking history - Favorite workers - Upload issue photos/videos - Live booking tracking - Real-time notifications - In-app messaging - Voice search - AI issue diagnosis assistant - Cost estimation system - Review & rating system - Loyalty rewards points - Membership subscriptions Booking Flow: - Choose service - Select date/time - Instant booking or scheduled booking - Upload issue details - Get price estimate - Choose worker - Secure payment - Live tracking - Completion confirmation - Leave review --------------------------------------------------- 3. SERVICE PROVIDER PANEL --------------------------------------------------- Worker Registration: - Identity verification - License upload - Certification upload - Portfolio upload - Background verification - Skill selection Worker Dashboard: - Job management - Accept/reject jobs - Availability schedule - Earnings dashboard - Wallet & payouts - Route navigation - Customer messaging - Tax reports - Analytics dashboard - Ratings management - Service area configuration Worker Features: - Real-time job notifications - Emergency job priority - Dynamic pricing - Before/after project gallery - Video consultation - Subscription plans - AI recommendations --------------------------------------------------- 4. ADMIN PANEL --------------------------------------------------- Create a highly advanced enterprise admin dashboard. Admin Features: - User management - Worker management - KYC verification system - License approval system - Booking management - Live service monitoring - Real-time map dashboard - Commission management - Revenue analytics - Refund management - Subscription management - Fraud detection system - Fake review detection - Ticket support system - CMS management - Promotional banners - Referral system - Push notification manager - Email campaign system - Regional management - Dispute resolution center - Audit logs - Role-based permissions Admin Roles: - Super Admin - Finance Manager - Support Manager - Verification Team - Regional Manager - Marketing Manager --------------------------------------------------- 5. AI FEATURES --------------------------------------------------- Integrate AI-powered tools: - AI chatbot assistant - AI issue diagnosis - AI worker recommendation engine - AI fraud detection - AI pricing suggestions - AI smart scheduling - AI customer support assistant --------------------------------------------------- 6. ADVANCED FEATURES --------------------------------------------------- Add: - Emergency booking system - Subscription maintenance plans - Warranty tracking - Video consultations - Multi-language support - Multi-city support - Real-time chat - Voice assistant support - Smart home integration - Referral program - Promo codes - Dynamic surge pricing - Service packages - Loyalty system - Seasonal offers - Service reminders --------------------------------------------------- 7. SECURITY FEATURES --------------------------------------------------- Implement: - End-to-end encryption - Rate limiting - Secure payment processing - Fraud prevention - Admin audit logs - OTP verification - 2FA - Secure API architecture - Cloudflare protection - Session management --------------------------------------------------- 8. MOBILE EXPERIENCE --------------------------------------------------- Create fully responsive mobile-first UI: - Mobile app style experience - Sticky bottom navigation - Swipe interactions - Push notifications - Real-time updates --------------------------------------------------- 9. DATABASE STRUCTURE --------------------------------------------------- Create scalable database models for: - Users - Workers - Services - Bookings - Payments - Reviews - Notifications - Tickets - Wallets - Analytics - Admin roles - Membership plans - Promotions --------------------------------------------------- 10. DESIGN REQUIREMENTS --------------------------------------------------- The UI should look: - Premium - Smooth - Enterprise-grade - Modern startup quality - Similar quality to Uber, Airbnb, Stripe, and modern SaaS platforms Use: - Animated dashboards - Glass cards - Smooth hover effects - Skeleton loaders - Real-time UI updates - Beautiful charts - Modern analytics widgets --------------------------------------------------- 11. OPTIONAL FUTURE FEATURES --------------------------------------------------- Prepare scalable architecture for: - Mobile apps - Franchise management - AI voice booking - Smart IoT integrations - AR home repair assistance - NFT warranty certificates - Blockchain payments --------------------------------------------------- 12. FINAL REQUIREMENTS --------------------------------------------------- Generate: - Complete frontend UI - Backend API structure - Database schema - Authentication system - Admin dashboard - Worker dashboard - User dashboard - Responsive design - Premium animations - Production-ready architecture - SEO optimization - Performance optimization - Clean folder structure - Scalable enterprise codebase The final product should feel like a billion-dollar startup platform.

LandingUsersLoginSupportCMSWorkers
Landing

Comments (0)

No comments yet. Be the first!

System Requirements

System Requirement Document
Page 1 of 5

lunar-marketplace

Introduction

The lunar-marketplace is a modern, premium, scalable full-stack web platform designed for a household services marketplace. It allows users to hire trusted professionals for various home maintenance and repair services. The platform aims to combine the best features of Uber, Airbnb, and TaskRabbit, with a cinematic premium SaaS design.

System Overview

The lunar-marketplace will provide a seamless experience for users to book household services such as plumbing, electrical work, cleaning, HVAC maintenance, carpentry, painting, appliance repair, landscaping, handyman services, and emergency home services. The platform will offer a premium modern UI with both dark and light modes, cinematic gradients, and smooth animations. It will be fully responsive and include professional enterprise dashboard styles with 3D hover effects and motion animations using Framer Motion.

Page 2 of 5

Functional Requirements

  • As a User, I should be able to register and log in using social login options.
  • As a User, I should be able to manage my profile and saved addresses.
  • As a User, I should be able to view booking history and favorite workers.
  • As a User, I should be able to upload issue photos/videos for service requests.
  • As a User, I should be able to track live bookings and receive real-time notifications.
  • As a User, I should be able to use voice search and AI issue diagnosis assistant.
  • As a User, I should be able to get cost estimations and leave reviews.
  • As a User, I should be able to earn loyalty rewards points and subscribe to membership plans.
  • As a Service Provider, I should be able to register with identity verification and skill selection.
  • As a Service Provider, I should be able to manage jobs, availability, and earnings.
  • As a Service Provider, I should be able to communicate with customers and manage ratings.
  • As an Admin, I should be able to manage users, workers, and bookings.
  • As an Admin, I should be able to monitor services in real-time and manage commissions.
  • As an Admin, I should be able to handle fraud detection and manage promotional content.

User Personas

  • User: Individuals seeking household services for maintenance and repair.
  • Service Provider: Professionals offering household services.
  • Admin: Personnel managing the platform's operations and user interactions.
Page 3 of 5

Visuals Colors and Theme

  • primary: #1E3A8A (Deep Blue)
  • primary_light: #3B82F6 (Light Blue)
  • secondary: #F97316 (Vibrant Orange)
  • accent: #10B981 (Emerald Green)
  • highlight: #F59E0B (Amber)
  • bg: #F3F4F6 (Light Gray)
  • surface: rgba(255, 255, 255, 0.8) (White with transparency)
  • text: #111827 (Dark Gray)
  • text_muted: #6B7280 (Muted Gray)
  • border: rgba(209, 213, 219, 0.5) (Light Gray)

Signature Design Concept

The homepage of lunar-marketplace will feature an interactive galaxy map where each star represents a service category. Users can click on a star to open detailed service cards, drag to rotate the galaxy, and hover to highlight connections between related services. This concept will be brought to life using @react-three/fiber and @react-three/drei for 3D interactions, creating an immersive and engaging experience that reflects the platform's premium and innovative nature.

Page 4 of 5

Interaction Model & Motion Direction

The landing page will utilize a "parallax" interaction model, providing a layered depth experience via scroll. Decorative layers will translate at different speeds, while real content remains in the normal flow. This approach is ideal for creating a visually rich first impression. Internal pages will adopt a "static" model to ensure clarity and speed for data-heavy interactions.

Non-Functional Requirements

  • The platform must support high concurrency and scalability.
  • It should ensure data security and privacy compliance.
  • The system should be optimized for performance and SEO.
  • The platform should offer multi-language and multi-city support.

Tech Stack

  • Frontend: Next.js 15, React, Tailwind CSS, Framer Motion, ShadCN UI
  • Backend: Node.js, NestJS or Express, PostgreSQL, Prisma ORM, Redis
  • Authentication: JWT, OAuth, Google login, Phone OTP, Two-factor authentication
  • Infrastructure: Docker, VPS deployment, Cloudflare, CDN
  • Payments: Stripe, PayPal, Wallet system, Escrow payments
  • Maps & Tracking: Google Maps API, Real-time tracking, Distance calculation
Page 5 of 5

Assumptions and Constraints

  • The platform will initially target the Canadian market, with plans for global expansion.
  • The system will prioritize household services as a defined works category.
  • The platform will require a robust internet connection for optimal performance.

Glossary

  • SaaS: Software as a Service
  • UI: User Interface
  • API: Application Programming Interface
  • JWT: JSON Web Token
  • CDN: Content Delivery Network
  • OTP: One-Time Password
  • 3D: Three-Dimensional

This document outlines the comprehensive requirements for the lunar-marketplace, ensuring a premium and scalable platform for household services.

Login: Admin Sign In
Dashboard: View Overview
Users: Manage Users
Workers: Verify KYC
Workers: Approve Licenses
Bookings: Monitor Live
Bookings: Resolve Disputes
Revenue: View Analytics
Commission: Manage Rates
Fraud: Detect Issues
Support: Handle Tickets
CMS: Manage Content
Promotions: Create Campaigns