CinePulse is a high-performance, open-source movie and TV show streaming discovery engine. Built for speed and aesthetics, this React 19 movie application uses a sleek, dark-mode glassmorphic design to provide a cinematic experience. It leverages the TMDB API for comprehensive metadata and integrates multiple streaming providers for a seamless viewing experience.
| Home Dashboard | Deep Discovery |
|---|---|
 |
 |
| High-performance movie browsing with dynamic hero sections and horizontal scrolling. | Detailed movie metadata, cast profiles, and franchise collections. |
| Cinematic Player | Viewer Analytics |
|---|---|
 |
 |
| Advanced video player with binge-mode auto-play and multi-provider support. | Personal watch time analytics and genre heatmap tracking. |
- 💎 Premium Design: A state-of-the-art UI utilizing glassmorphism, fluid micro-animations, and a curated dark-mode palette.
- 🧠 Intelligent Pickers: Can't decide? Use Decision Mode (mood-based) or Quick Pick to find your next favorite movie in seconds.
- 📊 Personal Insights: A dedicated stats dashboard tracks your total watch time, favorite genres, and viewing frequency.
- 📱 Mobile-First Native Feel: Experience smooth, 60fps transitions and gesture-friendly navigation on any device.
- 🔍 Global Search: Lightning-fast search functionality powered by the TMDB ecosystem.
- Frontend: React 19, Vite, Tailwind CSS 4.0
- Animations:
motion/react(Framer Motion) - Icons: Lucide React
- API: TMDB (The Movie Database)
- Backend: Express (Vite Proxy Middleware)
git clone https://github.com/madireis/cinepulse.git
cd cinepulse
npm installCreate a .env file and add your TMDB API Key:
TMDB_API_KEY=your_api_key_herenpm run devNavigate to http://localhost:3000 and start your journey.
This project is for educational purposes only. CinePulse is a frontend demonstration of modern web engineering.
- No Content Hosting: This application does not host or distribute copyrighted material.
- Metadata: All content info is provided via the TMDB API.
- Legal Compliance: Users are responsible for ensuring their usage aligns with local streaming laws.
CinePulse is actively evolving. Here's what's shipped and what's coming next.
| Feature | |
|---|---|
| ✅ | Premium dark-mode UI with glassmorphism & micro-animations |
| ✅ | TMDB integration — trending, popular, top-rated, upcoming |
| ✅ | Full Movie & TV Show detail pages with trailers |
| ✅ | Streaming player via embedded backend provider |
| ✅ | TV episode picker — season/episode navigation |
| ✅ | Decision Mode — mood-based movie picker |
| ✅ | Quick Pick — instant random suggestion |
| ✅ | Watchlist — save movies & shows locally |
| ✅ | Watch history tracking |
| ✅ | Personal Analytics dashboard — genre heatmap, watch time, streaks |
| ✅ | Global search — movies, TV shows, and actors |
| ✅ | Actor pages — full filmography with movie/TV filter |
| ✅ | Cast cards linked to actor profiles across all pages |
| ✅ | Dynamic episode headers — title & doc tab update on episode change |
| ✅ | Hard-reload episode switching to bypass provider cache |
| ✅ | SEO meta tags, keywords, and dynamic document titles |
| ✅ | Mobile-first responsive layout with slide-out nav |
| ✅ | Removed auth/sign-in — fully open, no account needed |
| ✅ | Multi-provider support — VidSrc.me, SuperEmbed, 2Embed, VidSrc Pro |
| ✅ | Provider selector UI — let user pick their preferred source |
| ✅ | 'Best' star badge indicator for recommended stream providers |
| ✅ | Keyboard shortcuts — F for fullscreen, arrow keys for episodes |
| ✅ | Trailer auto-play in hero section on hover |
| ✅ | Advanced filters — year range and runtime filtering |
| ✅ | Collections & franchises — view full MCU, Star Wars etc. |
| ✅ | Director & crew pages (linked from production info) |
| ✅ | Auto-play next episode toggle (Binge Mode) |
| ✅ | Social sharing — share favorite movies/shows with rich previews |
| Feature | Priority | |
|---|---|---|
| 🔲 | Continue Watching row on home dashboard | 🔥 High |
| 🔲 | Smart Player Fallback — auto-switch providers if a stream fails | 🔥 High |
| 🔲 | Cloud Sync — sync watch history & lists across devices | ⚡ Medium |
| 🔲 | Custom subtitle uploads (.srt / .vtt) in player | ⚡ Medium |
| 🔲 | Cast to TV / Chromecast support | ⚡ Medium |
| 🔲 | Picture-in-Picture (PiP) mode for player | ⚡ Medium |
| 🔲 | Progressive Web App (PWA) — install on mobile | 🧊 Low |
| 🔲 | Export watch history & lists as CSV | 🧊 Low |
Licensed under the MIT License.
Built with ❤️ for the cinematic community.