💖 MayaBazzar - The Ultimate Love & Laughs Roadmap

Welcome to MayaBazzar, a fun, feature-rich, and AI-powered love compatibility application with a unique Nepali cultural twist. This app goes beyond simple calculations by using Generative AI to create personalized, humorous, and highly shareable match results.

---

✨ Core Features

• 💑 Core Matching Logic: Calculates a compatibility score based on two names and zodiac signs.
• 🤖 AI-Powered Explanations: Generates hilarious, meme-style explanations in "Nepanglish" (a mix of Nepali and English).
• 🎤 AI-Powered Audio: Uses Text-to-Speech to create an audio version of the match results.
• 🎨 AI-Powered Image Generation: Creates a unique, abstract piece of art to visually represent each match.
• 🤣 AI-Powered Meme Integration: Finds and displays a relevant Nepali meme to complement the result.
• ❤️ Match History & Favorites: Users can save their match history and mark their favorite connections, with the ability to add personal notes.
• 🏆 Gamification & Badges: A full-featured badge system encourages users to explore the app by unlocking achievements.
• 👤 User Profiles: Users can save their name, zodiac sign, and a custom avatar to pre-fill match forms and track their stats.
• 🔮 AI Tools Suite:
  • Zodiac Deep Dive: An engaging, AI-powered content feature that provides a detailed, humorous analysis of zodiac pairings.
  • Relationship Oracle: An AI agent that answers user questions about their relationship in various tones (e.g., Funny, Serious, Spicy).
  • Yamraj's Clock: A humorous tool that provides a funny, unscientific prediction of a user's demise.
• 🎬 Animated Video Sharing: Generates a short, shareable video of the match result using the Veo video generation model.

---

🚀 Tech Stack

This project is a modern, full-stack application built with a focus on performance, developer experience, and cutting-edge AI integration.

• Framework: Next.js (App Router)
• UI Library: React with TypeScript
• Styling: Tailwind CSS
• Component Library: ShadCN UI
• Generative AI: Genkit (Google AI)
  • LLM: Gemini 2.0 Flash
  • Image Generation: Gemini 2.0 Flash Image Generation
  • Video Generation: Veo
  • Text-to-Speech: Gemini TTS
• State Management: Zustand
• Forms: React Hook Form with Zod for validation
• Deployment: Firebase App Hosting

---

📦 Getting Started

Prerequisites

• Node.js (v18 or newer recommended)
• npm or yarn

Installation

1. Clone the repository:

   git clone https://github.com/your-username/mayabazzar.git
   cd mayabazzar

2. Install dependencies:

   npm install

3. Set up your environment variables. Create a .env file in the root of the project and add your Google AI API Key:

   GEMINI_API_KEY="YOUR_API_KEY_HERE"

Running the Development Server

You can start the development server to see the app in action:

npm run dev

Open http://localhost:9002 in your browser to view the application.

---