Project
Movihoot - Group Movie Night Decider
Real-time multiplayer app that helps friend groups agree on what to watch
Overview
Movihoot is a Kahoot-style group movie selection app where a host creates a session, friends join via code, and everyone votes on movies in real time. Claude AI powers smart movie recommendations based on group preferences, while TMDB provides rich movie metadata.
How It Works
A host creates a room and shares a join code. Participants answer a short preference questionnaire, and Claude generates a tailored movie shortlist for the group. Players then vote in real-time Kahoot-style rounds until a winner is chosen — making movie night decisions fun instead of painful.
Real-Time Architecture
Built on NestJS with Socket.io for bidirectional real-time communication between all session participants. Firebase handles session state persistence, ensuring players can rejoin seamlessly and the host maintains full control over the game flow.
AI-Powered Recommendations
Claude API analyzes the group's collective preferences — genres, moods, languages, and viewing history — to generate a curated shortlist from the TMDB catalog. The recommendations balance individual tastes with group overlap, surfacing movies everyone is likely to enjoy.
CI/CD Pipeline
GitHub Actions handles automated builds and Docker image publishing on every push to main. The containerized NestJS backend and React frontend are independently deployable, with environment-specific configs managed via Docker Compose.