A free, open-source movie and TV show discovery platform. Browse 40+ curated films, 250+ TV shows, check ratings, cast info, episode guides, and find where to stream — all in one place.
Live: kinshow.vercel.app
Blog: kinshow.vercel.app/blog
Getting the repo running locally takes about two minutes:
git clone https://github.com/kiinshuk/kinshow.git
cd kinshow
npm install
npm run dev # → http://localhost:5173Then pick an issue tagged good first issue, fork, branch, and open a PR. Full guidelines: CONTRIBUTING.md (see the label glossary if you're not sure what a label means).
Before your first PR: run
npm run build— it must pass. If the build dirtiessrc/data/contributors.json, restore it withgit checkout -- src/data/contributors.jsonbefore committing.
- 40+ Curated Movies — Top-rated films with ratings, cast, and streaming links
- 250+ TV Shows — Full season and episode guides from TVmaze
- Smart Search — Instant search across movies and TV shows, with clear error/retry states when an API is unreachable
- Genre Explorer — Browse by Action, Comedy, Drama, Horror, Sci-Fi, Thriller, and more
- Watchlist — Save titles to watch later (localStorage, no account needed)
- Viewing History — Track what you've watched
- Recently Viewed — Quick access to recently browsed titles
- 7 Streaming Servers — VidSrc, VidSrc3, VidSrc2, VidCore, Peachify, VidFast, CineSrc
- Episode Navigation — Previous/next episode buttons for TV shows
- Server Switching — Change servers mid-session (keyboard
1–7,sto cycle) - Keyboard Shortcuts —
/search,Ctrl/Cmd+Kcommand search,?shortcut help
- Schema.org — Movie, TVSeries, WebSite, Organization, FAQPage, BreadcrumbList, BlogPosting, VideoObject
- Open Graph & Twitter Cards — Rich social previews with article metadata on blog posts
- Pre-rendered HTML — Every static route emitted at build time
- 24hr Cache — Reduced API calls, faster load times
- Fully Responsive — Desktop, tablet, and mobile
- Light & Dark Themes — System preference detection + manual toggle (persisted)
- Cookie Consent — GDPR compliant
- Blog — Movie guides, recommendations, and lists
| Technology | Purpose |
|---|---|
| React 18 | UI Framework |
| Vite 5 | Build Tool & Dev Server |
| React Router 6 | Client-side Routing |
| React Helmet Async | SEO Meta Tags |
| TVmaze API | TV Show Data & Images |
| OMDb API | Movie Data & Posters |
| Vercel | Hosting, Analytics & CI/CD |
- Node.js 18+
- npm (or yarn/pnpm)
# Clone the repository
git clone https://github.com/kiinshuk/kinshow.git
# Navigate to project directory
cd kinshow
# Install dependencies
npm install
# Start development server
npm run devThe app will be available at http://localhost:5173
npm run buildThis runs three steps: fetches the contributor roster (prebuild), bundles with Vite, then prerenders static HTML for SEO (prerender.mjs).
npm run preview # → http://localhost:4173No environment variables required — the app uses public TVmaze/OMDb endpoints with keys that ship in the client bundle.
- TMDB is blocked on some networks — the app uses TVmaze + OMDb only; you don't need TMDB to run anything.
src/data/contributors.jsonchanges after every build — it is regenerated byprebuild. Restore it (git checkout -- src/data/contributors.json) if you don't intend to commit roster changes.- Preview runs on port 4173, dev server on 5173. If a port is busy, stop the stale process or use
vite --port <other>.
kinshow/
├── public/
│ ├── robots.txt
│ └── sitemap.xml
├── scripts/
│ └── fetch-contributors.mjs # Regenerates contributor roster on build
├── src/
│ ├── components/
│ │ ├── Navbar.jsx # Navigation + search overlay
│ │ ├── Hero.jsx # Featured content carousel
│ │ ├── MediaCard.jsx # Movie/TV show card
│ │ ├── ContentRail.jsx # Horizontal scroll section
│ │ ├── CastCard.jsx # Actor profile card
│ │ ├── EpisodeCard.jsx # Episode list item
│ │ ├── CookieConsent.jsx # GDPR cookie consent
│ │ ├── RecentlyViewed.jsx # Recently viewed section
│ │ ├── ScrollButton.jsx # Back-to-top button
│ │ ├── Toast.jsx # Toast notifications
│ │ ├── EmptyState.jsx # Empty/error state views
│ │ ├── ErrorBoundary.jsx # Route error fallback
│ │ ├── Skeletons.jsx # Loading states
│ │ └── SEO.jsx # SEO, Schema.org, breadcrumbs
│ ├── pages/
│ │ ├── Home.jsx # Landing page with hero + rails
│ │ ├── Movies.jsx # Movie browser with tabs
│ │ ├── TVShows.jsx # TV show browser with tabs
│ │ ├── Detail.jsx # Movie/TV details + episodes
│ │ ├── Player.jsx # Multi-server video player
│ │ ├── Watchlist.jsx # User watchlist + history
│ │ ├── Explore.jsx # Genre explorer
│ │ ├── Blog.jsx # Blog listing page
│ │ ├── BlogPost.jsx # Blog article page
│ │ ├── About.jsx # About page with contributors
│ │ ├── Contact.jsx # Contact page
│ │ ├── Privacy.jsx # Privacy policy
│ │ └── NotFound.jsx # 404 page
│ ├── hooks/
│ │ └── useInfiniteScroll.js
│ ├── utils/
│ │ ├── poster.jsx # SVG poster generator
│ │ └── cookies.js # Cookie utilities
│ ├── api.js # API functions + caching
│ ├── blogData.js # Blog articles
│ ├── store.js # State management
│ ├── index.css # Global styles
│ └── main.jsx # Entry point
├── prerender.mjs # SEO prerender script
├── vercel.json # Vercel SPA config
├── CONTRIBUTING.md # Contribution guidelines
├── LICENSE # MIT License
└── package.json
We love contributions! Whether it's fixing a bug, adding a feature, or improving docs — all help is welcome.
Quick start:
- Fork the repo
- Create a branch:
git checkout -b fix/my-bug - Make your changes and verify
npm run buildpasses - Commit:
git commit -m "fix: description" - Push and open a PR (reference the issue:
Fixes #123)
See CONTRIBUTING.md for full guidelines.
Open issues: 300+ issues tagged good first issue are waiting — pick one that interests you.
MIT License — see LICENSE for details.
Kiinshuk — kinshuksharma2024@gmail.com
Project Link: https://github.com/kiinshuk/kinshow
If you found this project helpful, please give it a ⭐ on GitHub!