✦ Series Scout Desk

React TV discovery board powered by the public TVMaze API

---

✨ Highlights

• Search TV shows with TVMaze fuzzy search
• Load country/date schedule data alongside discovery results
• Filter by genre, status, minimum rating, and sort mode
• Score shows with a local scout-match model
• Render show posters directly from the API
• Inspect selected show rating, network, country, premiere date, summary, and links
• Save a watchlist in localStorage
• Vercel-ready static deployment

🛠️ Tech Stack

Layer	Technology
Framework	React 19
Language	TypeScript 6
Styling	Tailwind CSS 4
Icons	lucide-react
Build Tool	Vite 8
API	TVMaze API
Hosting	Static deployment ready

🗂️ Project Structure

react-series-scout-desk/
|-- public/
|   `-- favicon.svg
|-- src/
|   |-- lib/
|   |   `-- tvmazeApi.ts
|   |-- App.tsx
|   |-- index.css
|   `-- main.tsx
|-- LICENSE
|-- package.json
|-- vercel.json
`-- README.md

🚀 Local Development

npm install
npm run dev

🏗️ Build

npm run build

🌐 Vercel Deployment

🔌 API Note

This project uses public TVMaze endpoints:

https://api.tvmaze.com/search/shows?q=office
https://api.tvmaze.com/schedule?country=US&date=2026-04-25

TVMaze public endpoints do not require authentication.

📄 License

MIT License. See LICENSE.