Skip to content

AmirMotefaker/FilmTrack

Repository files navigation

Next.js Supabase TMDB TailwindCSS

🎬 FilmTrack

The ultimate open-source tracker and social network for movie & TV show fans.

Persian-first · Modern · Community-driven



✨ About FilmTrack

FilmTrack is a modern, Persian-first platform designed for movie and TV show enthusiasts. Track your watched content, get personalized release calendars, interact with a vibrant community without spoilers, and discover where to watch legally — all in one place.

Whether you're a casual viewer or a hardcore cinephile, FilmTrack brings your entertainment journey to life.


🌟 Features

Feature Description
🔐 User Authentication Secure sign-up and login powered by Supabase Auth, including Google and GitHub OAuth.
🏠 Dynamic Landing Page Hero section, trending movies/shows, and genre browsing with a responsive grid layout.
📊 Personal Dashboard A TV Time‑like interface showing real‑time user stats, watchlists, and personalized recommendations.
🎞️ Rich Title Pages Bilingual overviews (Persian/English), Cast & Crew photos, YouTube trailers, Seasons & Episodes list, and direct links to IMDb and Rotten Tomatoes.
🚫 Anti-Spoiler Commenting Comments are blurred if marked as spoilers, protecting users from unwanted plot leaks.
🔍 Live Search Secure API route with 300ms debounce for instant movie/TV show discovery.
📅 Personalized Calendar A comprehensive 7‑day calendar showing all upcoming episodes and movie releases sorted chronologically.
🇮🇷 Persian‑First UI Fully RTL interface with the beautiful Vazirmatn font.

🛠️ Tech Stack

  • Frontend: Next.js 16 (App Router), TypeScript, Tailwind CSS
  • UI Components: Shadcn UI & Lucide React
  • Backend & Auth: Supabase (PostgreSQL, Row Level Security, OAuth)
  • Data Source: TMDB API
  • Hosting: Vercel

🚀 Getting Started

1. Clone the repository

git clone https://github.com/AmirMotefaker/FilmTrack.gitcd FilmTrack

2. Install dependencies

npm install

3. Set up environment variables

Create a .env.local file in the root directory and add:

TMDB_API_KEY=your_tmdb_api_key
OMDB_API_KEY=your_omdb_api_key
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key

4. Run the development server

npm run dev

📖 Build in Public

This project is being built entirely in public! We believe in open-source and community-driven development.

Made with ❤️ for Iranians by Amir Motefaker

About

🎬 FilmTrack: The ultimate open-source Persian-first social network & tracker for Movies & TV Shows. The perfect alternative to TV Time.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Contributors