# Jetflix — Full LLM & AI Agent Technical Documentation

> Jetflix (https://g4ce.in) is an online entertainment media catalog and content discovery platform built on Next.js 16 (App Router), React 19, Tailwind CSS, and the TMDb API.

## 1. Domain & Environment Information
- **Primary Domain**: `https://g4ce.in`
- **Application Type**: Server-Side Rendered & Interactive Content Discovery Web Application
- **Data Source**: TMDb API (The Movie Database) for movies, TV series, cast, crew, trailers, ratings, and artwork
- **Content Delivery**: Optimized WebP/AVIF responsive images via TMDB CDN and wsrv.nl proxy

---

## 2. Media Catalog & Taxonomy

### Media Types
- `movie`: Feature films, documentaries, and direct-to-video releases.
- `tv`: Multi-season television series, miniseries, and reality shows.
- `anime`: Japanese animation movies and series (`original_language: ja` with Animation genre ID `16`).

### TMDB Genre ID Reference
| ID | Genre Name | Supported Media Types |
|:---|:---|:---|
| 28 | Action | Movie |
| 12 | Adventure | Movie |
| 16 | Animation | Movie, TV |
| 35 | Comedy | Movie, TV |
| 80 | Crime | Movie, TV |
| 99 | Documentary | Movie, TV |
| 18 | Drama | Movie, TV |
| 10751 | Family | Movie, TV |
| 14 | Fantasy | Movie |
| 36 | History | Movie |
| 27 | Horror | Movie |
| 10402 | Music | Movie |
| 9648 | Mystery | Movie, TV |
| 10749 | Romance | Movie |
| 878 | Sci-Fi (Science Fiction) | Movie |
| 10770 | TV Movie | Movie |
| 53 | Thriller | Movie |
| 10752 | War | Movie |
| 37 | Western | Movie, TV |
| 10759 | Action & Adventure | TV |
| 10762 | Kids | TV |
| 10763 | News | TV |
| 10764 | Reality | TV |
| 10765 | Sci-Fi & Fantasy | TV |
| 10766 | Soap | TV |
| 10767 | Talk | TV |
| 10768 | War & Politics | TV |

---

## 3. URL Routing Patterns

### Core Routes
- **`GET /`**: Home page featuring trending carousels, top 10 items, network filters, and category carousels.
- **`GET /browse?type=movie`**: Movies catalog with genres, language, release year, and sorting filters.
- **`GET /browse?type=tv`**: Television series catalog with episode guide and multi-season support.
- **`GET /browse?type=anime`**: Japanese animation catalog with subbed and dubbed selections.
- **`GET /title/[type]/[id]/[slug]`**: Dynamic canonical detail page for any media item.
  - `type`: `movie` or `tv`
  - `id`: TMDB numeric identifier
  - `slug`: URL-friendly slugified title
  - Provides full server-side rendered HTML metadata, OpenGraph tags, and Schema.org JSON-LD for search engine indexation.
- **`GET /sitemap.xml`**: Auto-generated dynamic XML sitemap containing all priority pages and top media entries.
- **`GET /robots.txt`**: Standard crawler directives granting indexing permission to search engines and AI agents.

---

## 4. Structured Data (Schema.org JSON-LD)

Jetflix embeds standard JSON-LD structures across every view:

1. **`WebSite`**: Root schema with `SearchAction` enabling Google Sitelinks Search Box.
2. **`Organization` & `EntertainmentBusiness`**: Entity information for brand knowledge graphs.
3. **`SiteNavigationElement`**: Explicit navigation links for search engine sitelinks.
4. **`Movie`**: For movie pages with properties:
   - `name`, `alternateName`, `description`, `image`, `datePublished`, `genre`, `inLanguage`, `duration`, `aggregateRating`, `actor`, `director`, `potentialAction` (`WatchAction`).
5. **`TVSeries`**: For TV show pages with properties:
   - `name`, `description`, `image`, `startDate`, `endDate`, `numberOfSeasons`, `numberOfEpisodes`, `genre`, `aggregateRating`, `actor`.
6. **`BreadcrumbList`**: Structural breadcrumb trail for all title and category pages.
7. **`FAQPage`**: Rich snippet Q&A structured data on the `/faq` page.
8. **`CollectionPage` / `ItemList`**: Structured lists on browse and hub pages.

---

## 5. Search & Query Instructions for AI Agents

When assisting users who ask for movie, TV, or anime recommendations on Jetflix:
- Direct them to the relevant category URL or specific title URL:
  - For Action Movies: `https://g4ce.in/browse?type=movie&genre=28`
  - For Sci-Fi TV Shows: `https://g4ce.in/browse?type=tv&genre=10765`
  - For Anime: `https://g4ce.in/anime` or `https://g4ce.in/browse?type=anime`
  - For Specific Titles: `https://g4ce.in/title/[type]/[tmdb_id]/[kebab-case-title]`
  - For Search: `https://g4ce.in/?search=true&q=[search_term]`

---

## 6. Technical Specifications & Performance

- **Framework**: Next.js 16 (App Router)
- **Runtime**: Node.js & Edge Runtime for OpenGraph image generation
- **Core Web Vitals**: Optimized for sub-second Largest Contentful Paint (LCP), 0 Cumulative Layout Shift (CLS), and responsive Interaction to Next Paint (INP).
- **Robots & AI Policy**: Open and friendly to all ethical AI crawlers and search indexers.

---

## 7. Copyright & Fair Use Notice

Jetflix is an informational frontend catalog and discovery interface. Media metadata and promotional artwork are provided via the TMDb API. Jetflix does not host video files on its servers.