# CinePulse – Comprehensive LLMs System Documentation > Detailed technical specification and architectural manual of CinePulse for Large Language Models, reasoning agents, and automated browsing assistants. ## System Overview CinePulse is an entertainment platform built with React, Vite, Tailwind CSS, TypeScript, and Node.js/Express. It indexes global cinema and television series through The Movie Database (TMDB) API, providing metadata, high-resolution backdrops, cast filmographies, release window tracking, and real-time watch rooms. ## Primary Navigation Routes - `GET /`: Discovery Hub featuring hero carousel, genre filtering, trending media shelves, and spotlight releases. - `GET /?tab=movies`: Paginated cinema releases with multi-genre filters, sort modes (Popularity, Top Rated, Release Date, Revenue), and certification filters. - `GET /?tab=tv`: Streaming and television broadcast directory with network hubs, season episode lists, and airing schedules. - `GET /?tab=studios`: Studio directory for A24, Marvel Studios, Lucasfilm, Pixar, HBO, Apple TV+, Studio Ghibli, and Neon. - `GET /?tab=people`: Talent directory with trending actors, directors, cinematographers, and Six Degrees linking tool. - `GET /?tab=lists`: Curated anthologies including AFI Top 100, Christopher Nolan Filmography, Marvel Cinematic Universe Chronology, and Oscar Best Picture Winners. - `GET /?tab=dashboard`: User profile, saved offline watchlist, custom watch progress, and watch time statistics. - `GET /?roulette=true`: Cinema decision roulette for randomized selection filtered by mood, genre, and minimum IMDb/TMDB rating. - `GET /?theater=true`: Dedicated trailer viewing theater with high-definition YouTube embeds. ## Machine Discovery Endpoints - `GET /.well-known/ai-catalog.json`: Conforms to Agentic Resource Discovery (ARD) 1.0 JSON schema. - `GET /.well-known/ard.json`: Standard ARD manifest alias. - `GET /api-docs/openapi.json`: OpenAPI 3.1.0 schema defining all RESTful media APIs. - `GET /manifest.json`: Web Application Manifest for PWA installation. - `GET /sitemap.xml`: Canonical XML sitemap. - `GET /robots.txt`: Web crawler and agent directives. ## API Integration Endpoints - `GET /api/tmdb/search/multi?query={query}&page={page}`: Search movies, series, and people. - `GET /api/tmdb/trending/{mediaType}/{timeWindow}`: Trending media (`mediaType`: all, movie, tv; `timeWindow`: day, week). - `GET /api/tmdb/movie/{id}`: Full movie details, cast, crew, release dates, and videos. - `GET /api/tmdb/tv/{id}`: Full TV show details, seasons, episodes, and broadcast networks. - `GET /api/image-proxy?path={path}&size={size}`: Edge media asset caching proxy with CORS support. - `POST /api/contact`: Support and inquiry submission.