Containerized Movie & Series Streaming Platform
CineGeek is a premium, fully dockerized streaming application that offers a vast library of movies and series. Designed for consistency and ease of deployment, it runs exclusively within a containerized environment, eliminating the need for local Node.js setups.
- 🎥 Smart Browsing: Explore collections sorted by genre, release date, or popularity.
- 🔍 Advanced Search: Instantly find content by title, director, or cast members.
- 🧠 Recommendation Engine: Personalized suggestions tailored to your preferences.
- 📱 PWA Support: Installable as a standalone, native-like app on mobile and desktop.
- 🐳 Pure Docker: Zero-dependency architecture; runs entirely in containers.
- 🎨 Responsive UI: Seamless viewing experience across all screen sizes.
- Docker Desktop: Ensure Docker is installed and running.
- Git: To clone the repository.
- Note: No Node.js or npm is required on your host machine.
-
Clone the repository and navigate to the root:
git clone [https://github.com/dragonpilee/cinegeek.git](https://github.com/dragonpilee/cinegeek.git) cd cinegeek -
Configure your environment variables:
cp .env.example .env # Open .env and add your TMDb API keys -
Build and launch the container:
docker-compose up --build
-
Open your browser and visit: http://localhost:3000
| Component | Technology |
|---|---|
| Core Framework | Next.js (React) |
| Language | TypeScript |
| Styling | Tailwind CSS |
| Data Sources | TMDb API, vidsrc |
| Infrastructure | Docker, Docker Compose |
Important: This project enforces a strict Docker-only workflow.
- Fork & Branch: Create a new branch for your feature.
- Develop: Test all changes inside the container (
docker-compose up). - Commit & Push: Submit your changes via Pull Request.
Developed with ❤️ by Alan Cyril Sunny
If you find this project helpful, please consider ⭐ starring the repository!
If you find this project helpful, please consider ⭐ starring the repository!