Advanced movie insight you won't find in one click. Search any film and generate ratings explained, skip guides, sensitivity warnings, international ratings, production facts, and historical-accuracy breakdowns.

Requirements

Node.js 22
A TMDB API key (https://www.themoviedb.org/settings/api)
An LLM API key (OpenRouter or any OpenAI-compatible endpoint)
PostgreSQL for caching generated insight cards (optional but recommended)

Copy .env.example to .env and fill in the keys.

Development with Docker (recommended)

Starts the app (with live reload) and the database, and runs migrations automatically on first start:

docker compose -f docker-compose.dev.yml up --build

Open http://localhost:3000
Source code is mounted for live reload (npm run dev inside the container)
Stop with docker compose -f docker-compose.dev.yml down

Development without Docker

npm install
npm run dev

Without a database the insight cards will still generate (they just won't be cached), thanks to graceful cache handling. Run npm run db:migrate against a reachable Postgres to enable caching.

Production

docker compose -f docker-compose.yml up --build

Scripts

npm run dev — start the Next.js dev server
npm run build — production build
npm run start — serve the production build
npm run lint — run ESLint
npm run db:migrate — apply database migrations