StreamVerse 🎬

A Netflix-like streaming platform to browse movies & TV shows, create watchlists, rate content, and get AI-powered recommendations.

🌐 Live Demo

---

✨ Features

Feature	Description
🎥 Content Discovery	Browse trending movies & TV shows, search, filter by genre/year/rating
👤 User Accounts	Email/password & Google OAuth authentication
⭐ Personalization	Watchlists, ratings, viewing history, favorite actors
🤖 AI Recommendations	Personalized suggestions powered by Google Gemini
📺 Watch Providers	See where to stream, rent, or buy (via JustWatch)
🎨 Dark/Light Mode	Theme toggle with responsive design
🛠️ Admin Dashboard	User management, content caching, analytics

---

🚀 Quick Start

Prerequisites

• Node.js 18+
• Firebase account (console.firebase.google.com)
• TMDB API key (themoviedb.org)

Installation

# Clone and install
git clone https://github.com/ageborn-dev/streamverse.git
cd streamverse
npm install

# Configure environment
cp .env.local.example .env.local
# Edit .env.local with your Firebase config

# Run development server
npm run dev

Open http://localhost:9002

Note: TMDB and Gemini API keys are configured via the Admin Dashboard (/admin/settings), not in .env.local.

---

🔧 Environment Variables

Create .env.local with your Firebase configuration:

NEXT_PUBLIC_FIREBASE_API_KEY=your_api_key
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com
NEXT_PUBLIC_FIREBASE_PROJECT_ID=your_project_id
NEXT_PUBLIC_FIREBASE_APP_ID=your_app_id
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=your_sender_id

---

🛠️ Tech Stack

Category	Technologies
Frontend	Next.js 15, React 18, TypeScript, Tailwind CSS, shadcn/ui
Backend	Firebase Auth, Firestore, Firebase Storage
APIs	TMDB API, Google Gemini AI
Deployment	Vercel

---

📁 Project Structure

src/
├── app/           # Next.js pages & API routes
├── components/    # React components (ui/, content/, layout/)
├── context/       # React Context providers
├── firebase/      # Firebase configuration
├── lib/           # Utilities & API helpers
└── ai/            # AI features (Genkit + Gemini)

---

🔐 Admin Access

1. Create an account and log in
2. In Firestore, set users/{your-uid}/isAdmin: true
3. Access /admin dashboard

---

📦 Commands

npm run dev       # Development (port 9002)
npm run build     # Production build
npm run lint      # ESLint
npm run typecheck # TypeScript check

---

🚀 Deploy to Vercel

1. Push to GitHub
2. Import repo at vercel.com
3. Add environment variables
4. Deploy!

---

📄 License

MIT License - see LICENSE

---

Created by Ageborn Dev • Built with ❤️ using Next.js & Firebase