explaingit

sanjarbek404/movie-mind

★ 20TypeScriptAudience · developerComplexity · 2/5ActiveLicenseSetup · easy

TLDR

An Uzbek language movie discovery web app built on the TMDb API with search, genre filters, favorites, and a related titles view.

Mindmap

mindmap
  root((MovieMind))
    Inputs
      TMDb API key
      User search queries
      Genre filters
    Outputs
      Movie detail pages
      Favorites list
      Related titles
    Use Cases
      Browse films in Uzbek
      Discover similar movies
      Save a personal watchlist
    Tech Stack
      React
      TypeScript
      Vite
      Tailwind
      Framer Motion

Things people build with this

USE CASE 1

Self host a localized movie browsing site backed by TMDb

USE CASE 2

Reuse the React and Tailwind UI as a starter for another media discovery app

USE CASE 3

Deploy the project to GitHub Pages with the included Actions workflow

USE CASE 4

Add a new language by translating the strings and reusing the same TMDb integration

Tech stack

ReactTypeScriptViteTailwindFramer Motion

Getting it running

Difficulty · easy Time to first run · 30min

Needs a free TMDb API key set as VITE_TMDB_API_KEY before npm run dev works.

MIT license, free for personal and commercial use with attribution preserved.

In plain English

MovieMind is a movie discovery website written entirely in the Uzbek language. It lets visitors browse recent and popular films, search for titles by name, filter by genre, look at details like the synopsis, director, cast, and trailer, and save favorites to a personal list. There is also a related-titles feature that shows other movies similar to the one you are viewing. The README is written in Uzbek and the project is aimed at Uzbek-speaking film fans who want a localized way to browse what is on screen. The data behind the site comes from the TMDb API, which is a public movie database. The project itself does not host any video files or movie content. It only pulls metadata such as titles, descriptions, posters, and ratings from TMDb and presents them in a custom interface that has been translated into Uzbek. On the technical side, MovieMind is a frontend-only web application. It is built with React using the Vite build tool, written in TypeScript, styled with Tailwind CSS, animated with Framer Motion, and uses Lucide React for its icons. The design is described as responsive, so it adjusts to desktop, tablet, and mobile screens. To run it locally, you clone the repository, run npm install, create a .env file with your own TMDb API key under the variable VITE_TMDB_API_KEY, and then start it with npm run dev on a local port. The repository also ships with a GitHub Actions workflow that builds the site and publishes it to GitHub Pages automatically when you push changes. The project is by Sanjarbek Otabekov, released under the MIT license, has 20 stars, and is written in TypeScript.

Copy-paste prompts

Prompt 1
Clone Movie-Mind, add my TMDb key to .env as VITE_TMDB_API_KEY, and run it locally with npm run dev
Prompt 2
Extend the related-titles feature to also surface director-based recommendations
Prompt 3
Localize the Uzbek UI into English while keeping the TMDb data fetching unchanged
Prompt 4
Adapt the GitHub Actions workflow to deploy this Vite app to Cloudflare Pages instead
Prompt 5
Add a watch-history page that persists in localStorage on top of the existing favorites feature
Open on GitHub → Explain another repo

Generated 2026-05-22 · Model: sonnet-4-6 · Verify against the repo before relying on details.