---

🏆 The Problem & Solution

😟 The Problem: Social Anxiety

67% of people draft a post but delete it before publishing due to fear of judgement, trolling, or low engagement. We lack a "safe space" to test our digital presence against reality.

💡 The Solution: SocialMirror

SocialMirror is a "Flight Simulator" for social media. It allows you to test-drive your content against AI agents simulating 8 different realistic personas (from Trolls to Super Fans) before you post it to the real world.

Built with Google Gemini 2.5 Flash advanced Multimodality (Vision + Text) & Reasoning.

---

🚀 Live Demo

Check out the live application here:

🌐 https://socialmirrorg.netlify.app/

---

✨ Key Features

• 📸 Multimodal Analysis: Upload an image + caption. The AI "sees" visual details (e.g., messy background, lighting, outfits) and "reads" the tone to generate context-aware comments.
• 🎭 8 Unique AI Personas:
  • The Troll (Roasts flaws in the image)
  • The Super Fan (Uses ❤️ emojis)
  • The Intellectual (Critiques grammar/logic)
  • The Gen-Z (Slang heavy: "no cap", "fr")
  • The Concerned Relative (Asks personal questions)
• 🌍 Platform Context Switcher: Switch modes between Instagram (Lifestyle), Twitter/X (Chaos), LinkedIn (Professional), and Snapchat (Casual).
• 🗣️ Native Language Support: If you type in Hindi/Hinglish, the AI agents reply in the same language.
• 🧠 AI Coach Dashboard: Get a "Controversy Risk Score" (0-100) and actionable advice to improve engagement.
• 🌗 Responsive UI: Glassmorphism design with Dark/Light mode toggling.

---

🛠️ Tech Stack

• Frontend: React.js (Vite)
• Language: JavaScript (ES6+)
• Styling: Tailwind CSS + Framer Motion
• AI Model: Google Gemini 2.5 Flash (via Google GenAI SDK)
• Deployment: Netlify

---

🚀 Run and Deploy (Locally)

This project contains everything you need to run your app locally.

View your app in AI Studio: Click Here

Prerequisites

• Node.js installed on your machine.
• A Google Gemini API Key.

Installation Steps

1. Clone the repository:

   git clone https://github.com/ramkachhwaha/SocialMirror.git
   cd SocialMirror

2. Install dependencies:

   npm install

3. Set up Environment Variables: Create a file named .env in the root directory and add your key: (Note: The VITE_ prefix is mandatory for Vite apps)

   VITE_GEMINI_API_KEY = your_actual_api_key_here

4. Run the app:

   npm run dev

Open your browser and navigate to http://localhost:5173 to start coding!

---

📂 Project Structure

SocialMirror/
├── public/              # Static assets (Favicons)
├── src/
│   ├── components/      # React Components (Input, Results, Footer)
│   ├── App.jsx          # Main Application Logic
│   ├── index.css        # Tailwind & Custom Styles
│   └── main.jsx         # Entry Point
├── .env                 # API Keys (Not pushed to GitHub)
└── README.md            # Documentation

---

---

🤝 Contributing

This project is a proudly created submission for the Google DeepMind Coding Hackathon. We welcome contributions! Feel free to fork the repository, create issues, or drop a star ⭐ if you liked the vibe.

_{Designed & Developed with ❤️ by ramkachhwaha
This project is a submission for the Google DeepMind Gemini 3 Pro Hackathon.
© 2025 SocialMirror. All rights reserved.}