`# 🎬 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
- Fork the repo
- Create a feature branch
- Make your changes
- 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.`
Top comments (0)