Anime Tracker

Track your anime watchlist and get notified when new episodes drop. Available as a Chrome extension and a web app.

Features

Web App (animetracker.lol)

• Watchlist with episode-level tracking (list and card views)
• Anime search with multi-provider fallback (AniList, Jikan, Kitsu)
• Weekly airing schedule (Mon-Sun grid)
• Smart recommendation engine with taste profiling
• Franchise watch order (BFS traversal)
• Buddy system with friend recommendations
• Shareable playlists and public profiles
• AniList OAuth and Kitsu watchlist import
• Notification feed (episodes, sequels, buddy requests, achievements)
• SFW/NSFW toggle

Chrome Extension (Web Store)

• Search and add anime to your watchlist
• Episode tracking with click-to-toggle grid
• Background polling with native OS notifications
• Notification feed as default view

Quick Start

Web App

cd web
cp .env.local.example .env.local  # fill in Supabase keys
npm install
npm run dev

Chrome Extension

1. Copy ext/lib/config.example.js to ext/lib/config.js and fill in values
2. Open chrome://extensions, enable Developer Mode
3. Click "Load unpacked" and select the ext/ folder

See docs/getting-started.md for the full setup guide.

Monorepo Structure

anime-tracker/
  ext/          # Chrome Extension (Manifest V3, vanilla JS)
  web/          # Web App (Next.js, TypeScript, Tailwind, Supabase)
  functions/    # Netlify scheduled/background functions
  docs/         # Contributor documentation
  scripts/      # Admin scripts (gitignored)

Documentation

Guide	Description
Getting Started	Setup instructions for both web app and extension
Architecture	System overview, data flow, deployment
Web App	Routes, components, lib modules, styling
Extension	Manifest V3, service worker, storage
Database	Supabase schema, RLS policies, RPCs
Providers	Multi-provider fallback, caching, pagination

Contributing

We welcome contributions! See CONTRIBUTING.md for the workflow, code style, and PR process.

Tech Stack

• Web: Next.js, TypeScript, Tailwind CSS v4, Supabase
• Extension: Vanilla JS, Manifest V3, ES modules
• Data: AniList GraphQL API (primary), Jikan/MAL and Kitsu (fallbacks)
• Hosting: Netlify (web + functions), Chrome Web Store (extension)

License

Apache 2.0 -- see LICENSE