# Scorpia Stream & Media Discovery

> **Status:** Live on Production (`https://thescorpia.com/stream`)  
> **Repository:** Private Internal Repository  
> **Tech Stack:** Next.js (App Router), React 19, TypeScript, Tailwind CSS, TMDB REST API, Vercel Edge Rewrites

---

## 1. Overview & Introduction
**Scorpia Stream & Media Discovery** is a fast, cinema-grade movie and television catalog platform deployed under `/stream` on `thescorpia.com`. It aggregates real-time metadata, trending releases, ratings, and multi-criteria catalog filtering into a responsive streaming discovery interface.

## 2. The Operational Problem
Standard media databases clutter discovery with intrusive ads, slow page transitions, and fragmented filtering between movies and television series. Scorpia Stream was engineered to provide an instant, zero-clutter browsing experience with unified genre taxonomy, release-year filtering, and edge-cached responses.

## 3. System Architecture
```
[Client Browser (thescorpia.com/stream)]
       │
       ▼
[Vercel Edge Rewrite Proxy (vercel.json)]
       │
       ▼
[Next.js App Router & Server Components]
  ├── Hero Spotlight Carousel (Top 10 Featured Releases)
  ├── Trending & New Release Shelves
  └── Multi-Faceted Catalog Filter Engine (Genre, Year, Rating)
       │
       ▼
[TMDB API Integration & Server-Side Cache Layer]
```

## 4. Key Features
- **Featured Spotlight Carousel:** High-impact widescreen hero banner showcasing top releases with synopsis, release year, and genre tags.
- **Unified Catalog Filtering:** Instant filtering across 25+ movie and TV genres, release years, and minimum rating thresholds (`9.0+`, `8.0+`, `7.0+`, `6.0+`).
- **Subpath Edge Routing:** Seamlessly mounted at `/stream` alongside the main portfolio via Vercel edge rewrites without cross-origin latency.
- **Responsive Cinema Grid:** Adaptive poster grid with smooth hover transitions and optimized image loading.
