`# 🎬 MovieMania: Open Source MERN Stack Entertainment Tracker – Seeking Contributors!

Hey everyone! 👋

I've been working on MovieMania, a full-featured entertainment tracking platform built with the MERN stack, and I'm looking for contributors to help take it to the next level!

What is MovieMania?

It's a Netflix-style tracker where you can:

• 🎬 Log movies and TV shows with ratings, reviews, and tags
• 📊 See beautiful stats with charts, heatmaps, and viewing streaks
• 🤖 Get AI-powered recommendations based on your taste
• 📺 Track TV series progress (season/episode tracking)
• 🔍 Smart search using natural language ("sci-fi movies from 2020")
• 📁 Create themed collections
• 🌍 Find where to stream content (8 countries supported)
• 📈 Deep analytics for TV shows (episode ratings, quality trends)

Tech Stack

Backend: Node.js, Express, MongoDB, JWT Auth, Google Gemini AI

Frontend: React 18, Vite, Tailwind CSS, Framer Motion, Recharts

APIs: TMDB, OMDb (IMDb ratings), JustWatch

What We Need Help With

✅ Already Built:

• Complete CRUD for movies & TV shows
• AI features (smart search, review assistant, predictive ratings)
• Stats dashboard with visualizations
• TV analytics with IMDb integration
• Watchlist, collections, import/export
• Beautiful UI with theme system (Light/Dark/OLED + 6 accent colors)

🔜 Looking for Contributors:

• React Native mobile app (iOS/Android)
• Testing & bug fixes
• Performance optimizations
• Documentation improvements
• UI/UX enhancements
• New features (see roadmap in repo)

Why Contribute?

• 📚 Great for learning MERN stack
• 🎨 Beautiful, modern codebase with best practices
• 🤝 Welcoming to all skill levels
• ⭐ Build your portfolio with a real-world project
• 🚀 Active development and responsive maintainer

Getting Started

The setup is straightforward:

`bash
git clone https://github.com/yourusername/moviemania.git
cd moviemania
npm run install:all

Configure .env (MongoDB + TMDB API key)

npm run dev
`

We also provide sample MongoDB data to get you up and running instantly!

Links

📦 GitHub: https://github.com/x-neon-nexus-o/MovieMania
📖 Full Documentation: Check the README in the repo

🎥 Demo: Not Yet Deployed
💬 Discord/Slack: x_neon_nexus_o

How to Contribute

1. Fork the repo
2. Create a feature branch
3. Make your changes
4. Submit a PR with a clear description

I'm happy to help onboard new contributors and discuss ideas. Whether you can code, design, write docs, or test – all contributions are welcome!

Let me know if you have questions or ideas. Looking forward to building this together! 🚀

P.S. This uses TMDB API but is not endorsed by TMDB. Built with ❤️ for entertainment lovers.`