How nyumat/nyumatflix works
Project type and purpose
• NyumatFlix is a full-stack, server-side-rendered (SSR) streaming-aggregator web application built on Next.js (App Router).
• Its purpose is to fetch and surface movies, TV shows, anime, etc., with filtering, search, pagination, and content-row carousels, sourcing metadata from external APIs (TMDb, FMHY VPS).
File structure
• Top-level “app/” directory: Next.js App Router.
• app/page.tsx, app/layout.tsx, plus nested folders for routes (home, movies, tvshows, search, country, genre, watch, etc.).
• app/api/: each folder under app/api/ is a serverless function route that implements data-fetching endpoints (e.g., /api/movies/[id]/route.ts).
• “components/”: UI component library, organized by feature (content, hero, ui primitives, search, tvshow, etc.).
• “lib/”: shared business logic – constants, fetchers, Zustand stores.
• “hooks/”: React hooks to encapsulate client-side state & data fetching.
• “utils/” and “utils/filters.json”: pure utilities and filter definitions.
• “public/”: static assets (preview.png, favicon, etc.).
• Config files: next.config.mjs, tailwind.config.ts, jest/vitest configs, ESLint, Prettier, Husky, Vercel.
README for additional insights
• Confirms SSR, Next.js, TypeScript, Tailwind.
• Mentions TMDb + FMHY VPS environment variables.
• Outlines dev scripts and dependencies.
Essential elements, but avoid over-fragmentation
• Critical paths: page load, search, filtering, detail page fetch flow.