Your personal movie memory vault.

Live App

Overview

WatchMemo is a movie tracking web app focused on personal context, not just lists.

You can discover movies publicly, and when you log in, you can keep a private watched history with ratings and personal notes.

Current Features

• Movie discovery homepage with trending, now playing, and upcoming movies
• Dedicated movie search and movie detail pages (no login required)
• Private watch history page with ratings, notes, edit, and remove actions
• Supabase authentication (login, signup, password reset, password update)
• Profile settings (display name + password update)
• Save watched movies with rating and optional note
• Edit or remove watched entries anytime
• Optimistic UI updates for save/edit/delete actions
• Loading skeletons and responsive mobile/desktop layout
• Dedicated routes for discovery, search, movie details, and watch history
• SEO setup with metadata, Open Graph, Twitter cards, sitemap, robots, and JSON-LD

Tech Stack

• Next.js 15 (App Router)
• React 19 + TypeScript
• Tailwind CSS v4
• shadcn-style UI components
• Supabase (Auth + Postgres)
• TMDB API (search, movie details, posters, and discovery)

Environment Variables

TMDB_API_READ_ACCESS_TOKEN=your_tmdb_api_read_access_token_here
NEXT_PUBLIC_SITE_URL=https://watchmemo.vercel.app
NEXT_PUBLIC_SUPABASE_URL=https://your-project-ref.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_supabase_anon_key

The TMDB read access token is used only on the server for movie search, details, posters, and discovery. Movie lists and details are cached to reduce API requests.

Data Layer

Database schema and RLS policies:

• supabase/schema.sql

Main table:

• public.watched_movies

Core columns used by the app:

• user_id
• imdb_id
• user_rating
• comment
• movie_snapshot (JSON snapshot for quick watched list rendering)
• created_at, updated_at

Existing watch history remains compatible. Rows keep their current imdb_id values; new movie snapshots also include the TMDB ID. Movies without an IMDb ID use a tmdb:-prefixed value in the existing text key, so no history-table migration is required.

Scripts

npm run dev
npm run lint
npm run build
npm run start

Product Behavior

• Guests can browse and search freely.
• Login is only required for persistent actions (save/edit/delete watched data).
• User records are isolated through Supabase Row Level Security (RLS).

Contributing

Useful contributions are welcome.

Open an issue or PR with:

• clear problem statement
• reasoning and expected behavior change
• screenshots/video for UI updates
• notes about edge cases or migration impact

Preference is given to product-level improvements over superficial refactors.

Links

• Live: https://watchmemo.vercel.app
• GitHub: https://github.com/CodeWithAlamin
• X: https://x.com/CodeWithAlamin
• LinkedIn: https://linkedin.com/in/codewithalamin