ShopSphere: The future of online retail is here. Experience an unparalleled e-commerce platform that integrates Artificial Intelligence, vibrant Social Commerce, and immersive Web Augmented Reality to deliver hyper-personalized and engaging shopping journeys. Designed for modern businesses, ShopSphere offers a full-stack solution to stand out in the competitive digital marketplace.

• AI-Powered Personalization:
  • Intelligent Product Recommendations (Homepage, Product Details Page)
  • Dynamic Content Curation based on user behavior
  • Integrated Voice Search for effortless product discovery
  • Personalized Deals & Offers
• Dynamic Social Commerce:
  • Live-stream Shopping Platform with real-time video and chat functionality
  • Real-time Chat Console for Admin to interact with live viewers
  • Robust User-Generated Content (UGC) - Product Reviews & Ratings
  • Influencer Integration & Curated Collections
• Immersive WebAR Experience:
  • Advanced Conditional AR: If admin provides a 3D model, direct 3D model viewing in environment.
  • If no 3D model, user-uploaded photo-based Virtual Try-on (for clothing) or See-in-Your-Space (for home decor) with AI image processing.
  • Feature activation controlled via backend .env flag.
• Comprehensive E-commerce Core:
  • Advanced Product Catalog Management (Variants, Gallery Images, Detailed Pricing, SEO)
  • Powerful Search with Live Suggestions & Dedicated Results Page
  • Secure Shopping Cart & Seamless Multi-step Checkout
  • Multiple Payment Gateways: Stripe, Razorpay (UPI, Netbanking, Cards), PayPal, Cash on Delivery (COD)
  • Flexible Shipping Zones & Rates with Free Shipping Threshold
  • Robust Order Management (User tracking, Admin status updates, Return/Cancellation requests, Refund processing info)
  • Guest User Functionality (Browse, Cart, Wishlist; mandatory login for checkout)
  • User Wishlist & Full Account Management (Dashboard, Orders, Addresses, Settings)
• Powerful Admin Panel:
  • Intuitive Dashboard with Real-time KPIs & Analytics
  • Full Product Management (Create, Edit, Archive, Delete; Multi-language content input, AR settings toggle)
  • Order Management with Real-time Updates & Notifications for user actions (returns, cancellations)
  • Customer Management (List, Details, Account Status, Contact)
  • Discounts & Promotions Manager (Create, Edit, Activate/Deactivate; Targeted & Broadcast, Real-time user impact)
  • SMS Notifications (Targeted & Broadcast to users based on segments like 'purchased in last 30 days')
  • CMS for Static Pages (Careers, Press, Privacy Policy, etc. - with Rich Text Editor, Multi-language content input)
  • Store Settings (General, Payments, Shipping, Notifications, Language Management)
  • Team Management with Role-Based Access Control (RBAC)
• Enhanced User Experience:
  • Multi-Language Support (10+ languages, Admin-managed, User-selectable, default English)
  • Branded UI Loaders (Skeleton Screens for content, Custom Spinner for actions)
  • Fully Responsive Design (Desktop, Tablet, Mobile)
  • SEO Optimization (Meta titles/descriptions, URL slugs)
  • Secure Firebase Authentication (Email/Password, Google, Facebook)
    

Features (Bulleted List)

• AI-powered Product Recommendations & Dynamic Content
• Live-stream Shopping Platform with Real-time Chat
• Interactive WebAR Virtual Try-on & See-in-Your-Space
• Comprehensive Admin Panel for full store and content management
• Role-Based Access Control (RBAC) for team management
• Secure Firebase Authentication (Email/Password, Google, Facebook)
• Multi-Language Support (10+ languages, Admin Configurable)
• Multiple Payment Gateways (Stripe, Razorpay, PayPal, COD)
• Advanced Product Management (Variants, SEO, Shipping)
• Real-time Order Tracking & Admin Notifications
• Built with [Frontend Framework] & [Backend Framework]
• Includes Branded UI Loaders (Skeleton Screens & Custom Spinner)

• Node.js v18.x or higher
• npm v9.x or higher (or Yarn v1.x or higher)
• MongoDB v6.x or higher
• Firebase Project (for Authentication)
• Accounts for Payment Gateways (Stripe, Razorpay, PayPal) if you wish to use them.
• Account for SMS Service (e.g., Twilio) if you wish to use it.
• Account for a Premium AI/AR Image Processing Service (e.g., Remove.bg) if you wish to use advanced WebAR.

• 1. Clone the ShopSphere repository.
• 2. Install Frontend & Backend dependencies (npm/yarn).
• 3. Configure backend/.env with MongoDB URI, Firebase Service Account path, Payment Gateway Secret Keys, SMS API Keys, and AR Service API Keys.
• 4. Configure frontend/.env with Firebase Web Config and Backend API URL.
• 5. Run 'npm run seed' in the backend to create a default Super Admin user and sample data.
• 6. Start Frontend & Backend servers.
• 7. Access Admin Panel at /admin/login (default admin: [email protected] / admin123) and perform initial configurations (Store Details, Payment Gateways, Languages, etc.).
• For detailed, step-by-step installation and configuration instructions, please refer to the comprehensive