3MTT Movie Recommendation App (Capstone Project)

A full-stack movie recommendation platform built as a capstone project for the 3MTT Fellowship (Cohort 3). It allows users to discover, review, and manage movies while interacting with others socially.

Author

• Torkuma Jonathan Yuwa

---

Key Features

• JWT-based user authentication
• Search movies by title, genre, year
• View detailed info, trailers, ratings
• Personalized movie recommendations
• Save favorites and manage watchlists
• Leave reviews and ratings
• Follow/unfollow other users
• Share and explore public watchlists

---

Project Structure

3mtt-capstone/
├── backend/     # Express.js + MongoDB REST API
└── frontend/    # React + Tailwind CSS PWA

---

Individual Project Docs

To see detailed features and documentation for each

• Backend Service (Node.js + Express + MongoDB)
  See backend/readme.md

• Frontend Client (React + TailwindCSS)
  See frontend/readme.md

---

Deployment Overview

Both parts of the app can be deployed independently.

Frontend options:

• Local
• Netlify
• Vercel

Backend options:

• Local
• Render
• Railway
• Any Node.js-compatible server

Make sure to:

• Set up environment variables correctly for each.
• Point the frontend API base URL to the deployed backend (REACT_APP_API_URL).

---

CI/CD Integration

This project uses Continuous Integration and Continuous Deployment (CI/CD) to automate builds and deployments for both the frontend and backend.

Frontend

• Platform: Vercel
• Trigger: Automatic deployment on every push to the main branch via GitHub Actions.
• Secrets: Managed in GitHub repository settings.

Backend

• Platform: Render
• Trigger: Automatic deployment on push to the main branch using a Render Deploy Hook triggered by GitHub Actions.
• Secrets: RENDER_DEPLOY_HOOK_URL stored in GitHub repository secrets.

CI/CD ensures that all changes are automatically built and deployed without manual intervention.

---

Author

• Torkuma Jonathan Yuwa
• 3MTT Fellow — Cohort 3
• Fellow ID: FE/24/1478283066
• GitHub: @bridgeyuwa