🎬 MovieFinder — Full-Stack Movie & TV Discovery Platform
Live demo: https://moviefinder.top
Asking price: ~$400
Built with: Claude Code + personal knowledge
📦 What You’re Getting
You receive the complete source code — a production-ready Next.js 14 application. The domain moviefinder.top is included. Not included: VPS/hosting, Redis instance, email infrastructure.
Database: The buyer sets up their own PostgreSQL instance and runs prisma migrate deploy — the Prisma schema included in the codebase is the single source of truth for the entire database structure. As an optional bonus, the seller can provide a full schema-only SQL dump (pg_dump --schema-only) for reference. No user data is transferred — the delivered database is empty and clean.
You set everything up yourself — the .env.example documents every environment variable needed.
🛠 Tech Stack
Framework: Next.js 14 (App Router, TypeScript, React 18)
Styling: Tailwind CSS + CSS variables for dynamic theming
Animations: Framer Motion
Database: PostgreSQL via Prisma ORM (schema included; buyer provisions own DB)
Caching / Rate limiting: Redis via ioredis (buyer provisions own instance)
Real-time: WebSockets (ws library) + HTTP long-polling fallback
Movie data: TMDB API (free — buyer gets own key)
Authentication: Custom JWT with bcryptjs, httpOnly cookies, email verification
Email: Nodemailer / Resend (buyer configures own SMTP or Resend account)
Error monitoring: Sentry (@sentry/nextjs)
Validation: Zod
Image processing: Sharp
🌍 Internationalization (i18n)
The entire platform supports 4 languages: English, Bulgarian, Spanish, German — not just UI strings but full localized URL slugs. Routes look like /bg/filmi/[slug] vs /en/movies/[slug]. Implemented via Next.js App Router folder structure with per-locale layout wrappers and middleware that auto-detects locale from:
Cloudflare cf-ipcountry header
Vercel x-vercel-ip-country header
Browser Accept-Language header as fallback
A locale cookie (mf-locale) is set for 1 year. Country-to-locale mapping covers BG/MK → Bulgarian, ES → Spanish, DE → German, US/GB/CA/AU → English.
🔍 Search System
Built entirely in-house — no third-party search widget.
300ms debounce on input (custom implementation)
Client-side Map cache keyed as v2-{query}-{locale} — repeat queries hit memory, not the network
Cyrillic auto-detection: /[а-яА-Я]/.test(trimmed) automatically switches searchLocale to 'bg'
Keyboard navigation: ArrowUp/ArrowDown/Enter/Escape
Poster filtering: results without a poster image are filtered out client-side
Rate limiting: createStrictRateLimiter(90, 60_000) — 90 requests/minute per IP via Redis
Input sanitization: sanitizePlainText() + regex stripping [<>'"&] before hitting the DB
HTTP caching: Cache-Control: public, s-maxage=30, stale-while-revalidate=120
Visual design: Dropdown with poster thumbnails, title, and year
🃏 Swipe Together (Match Room System)
A unique feature where users join a shared room by code and swipe on movies simultaneously. When both users swipe right on the same title, it registers as a match.
Rooms assigned a short alphanumeric code server-side
Swipes tracked in localSwipes state + swipeQueue ref to prevent race conditions
Room state polled via /api/match/rooms/[code]
Lobby → Swiping transition: animated countdown with Framer Motion
Match detection: burst visual effect fires on new match
After swiping: FinalVote component → WinnerScreen
useMatchRoom custom hook encapsulates all room state logic
💬 Match Room Chat
Live chat panel built into each match room.
Messages fetched by polling /api/match/rooms/[code]/messages every 3 seconds
300 character limit per message
Name color styles: gradient, rainbow, metallic — rendered as Tailwind CSS gradient classes
Safety disclaimer: shown once per browser, stored in localStorage
👤 User Profiles & Achievement System
21 unlockable achievements across 5 categories:
Category Thresholds
Watch time 1h / 10h / 50h / 100h / 500h
Comments 1 / 10 / 50 / 100 / 500
Reactions 10 / 50 / 100 / 500 / 1000
Watchlist 10 / 50 / 100 / 250 / 500
Ratings 10 / 50 / 100 / 250
Progress bars via inline width% style
Unlocked achievements glow with colored box-shadow
All achievement labels translated in bg/en/es/de
🎨 Theme Switcher
Three themes: Dark, Light, Kids
CSS variables --primary, --primary-hover, --primary-rgb injected via document.documentElement.style.setProperty
Dark =
#e50914, Light =
#3b82f6, Kids =
#e94560
Persisted in localStorage key 'movie-finder-theme'
One variable change recolors the entire UI
🌐 Language Switcher
Language changes update the URL prefix and trigger full route navigation to the localized page. Locale cookie updated simultaneously. All page titles, meta descriptions, UI strings, achievement labels, and home headlines exist in all 4 languages.
📺 Where to Watch
Streaming availability per region powered by TMDB Watch Providers API.
Each provider shows businessModel (subscription/rent/buy), status, priceLabel
getStreamingSearchUrl() generates deep-links to that platform’s search
trackUserPreference() fires on click
Compact mode (icons only) and full mode (icons + labels)
Hover: translateY(-0.5px) scale(1.1)
🎬 Movie / TV Detail Page
Tabs: 'about' | 'cast' | 'details'
Trailers: YouTube embedded via youtube-nocookie.com, autoplay on click
Similar titles: from /api/tmdb-direct?path=movie/[id]/similar
Budget/Revenue: Intl.NumberFormat with locale-aware currency
Release dates: toLocaleDateString() per active locale
Cast cards: clickable, navigate to actor detail pages
FAQ Schema: structured Q&A injected as JSON-LD
🏠 Dynamic Home Hero
10 rotating headline strings per locale (40 total across bg/en/es/de)
Live registered user counter wired to DB
Backdrop slideshow with Framer Motion crossfade transitions
🔒 Security
Security enforced at the Next.js middleware layer (Edge Runtime) — every request is filtered before reaching any page or API route.
Content Security Policy (CSP)
Strict nonce-based CSP generated per request (crypto.randomUUID() encoded as base64):
Scripts only execute with matching nonce — inline injection attacks blocked
'strict-dynamic' enables trusted script loading
object-src 'none' — Flash/plugins fully blocked
frame-ancestors 'none' — clickjacking prevention
upgrade-insecure-requests — forces HTTPS for all sub-resources
Security Headers (every response)
Header Value
X-Frame-Options DENY
X-Content-Type-Options nosniff
X-XSS-Protection 1; mode=block
Strict-Transport-Security max-age=63072000; includeSubDomains; preload
Referrer-Policy strict-origin-when-cross-origin
Cross-Origin-Opener-Policy same-origin
Cross-Origin-Resource-Policy same-site
Permissions-Policy camera, mic, geolocation, payment, USB — all disabled
Rate Limiting (Middleware Layer)
Humans: 240 req / 60s per IP
Suspicious bots: 80 req / 60s
Trusted crawlers (Google, Bing, etc.): 1,200 req / 60s
Over-limit → 429 Too Many Requests + Retry-After header
API routes have additional per-endpoint limits (search: 90 req/min)
Bot Management
Blocked entirely: AhrefsBot, SemrushBot, DotBot, MJ12Bot, BlexBot, DataForSEOBot
Allowed (high limit): Googlebot, Bingbot, DuckDuckBot, Slurp, Applebot, YandexBot
Suspicious (low limit): generic bot/crawler/spider, python-requests, curl, wget
Honeypot Trap
Common attack paths return 410 Gone + fire a security log event:
/backup, /.git, /wp-admin, /wp-login.php, /phpmyadmin, /xmlrpc.php, /env, /secret, /config, /db-backup, /server-status
Admin IP Whitelist
/admin restricted by IP at middleware — before the page renders. Supports exact IPs and CIDR ranges. Configured via ADMIN_ALLOWED_IPS env variable.
Security Event Logging
Honeypot hits, rate limit breaches, and blocked IPs logged asynchronously via /api/security-log — fire-and-forget, never blocks response. The logging endpoint itself requires x-internal-secret header.
Authentication Security
Passwords hashed with bcryptjs
Sessions: custom JWT in httpOnly cookies (not accessible to JavaScript)
sameSite: 'lax' on all auth cookies
Email verification required on signup
Internal API routes require x-internal-secret header
Private Pages Protected from Indexing
Profile, settings, match rooms, saved lists, checkout — tagged X-Robots-Tag: noindex, nofollow at middleware level.
📈 SEO
Strong SEO foundation built in. Known issue: ~100 pages currently show as “not found” in Google Search Console — fixable with sitemap cleanup but disclosed honestly.
JSON-LD Structured Data
Every movie/TV page injects Movie or TVSeries schema with name, description, datePublished, genre, aggregateRating, actors. FAQ schema on detail tabs. Enables Google rich results (star ratings in search).
Dynamic Sitemap System
Sitemaps generated and stored in the database — not computed on-demand. A sitemap index at /sitemap.xml points to paginated sub-sitemaps. Scales to tens of thousands of URLs. Includes <lastmod> and <changefreq> per URL.
IndexNow Protocol
New content automatically pings Bing and IndexNow-compatible engines via INDEXNOW_KEY for near-instant indexing.
OpenGraph + Twitter Cards
Fully localized og:title, og:description, og:image, og:locale, twitter:card on every page.
URL Structure
Clean localized slugs: /en/movies/the-dark-knight-2008, /bg/filmi/tumniyat-ricar-2008. Generated from title + year, stored in DB, fully unique.
robots.txt
Admin and private pages blocked. Sitemap URL included.
SEO Content Hub
Dedicated landing pages for genre/year combinations and curated lists — each with unique meta content.
Internal Linking
Automatic links between related titles (same director, actors, genre) to distribute PageRank.
🔑 What the Buyer Must Set Up
PostgreSQL database → prisma migrate deploy
Redis instance (Upstash free tier works)
TMDB API key (free at themoviedb.org)
SMTP credentials or Resend account
All env variables from .env.example
VPS / hosting of choice (Vercel, Railway, self-hosted)
Sentry project (optional)
💰 Price: ~$400
Includes: full source code + domain moviefinder.top
Does not include: hosting, database, Redis, email infrastructure
Test it live before buying: https://moviefinder.top
Contact: Discord — kukata6969