CoD Zombies Tracker
Project Link
About The Project
CoD Zombies Tracker is a free, open-source progress tracker for Treyarch Call of Duty Zombies. Players had no single place to track progress across maps, follow step-by-step Easter egg guides, find teammates, and compete on leaderboards without ads or paywalls. This full-stack web app solves that with structured EE guides, proof-backed run logging, per-map leaderboards, Find Group (LFG) with in-app chat, and an achievement/XP/rank system.
Solo project: design, implementation, content (EE seed data), deployment, and maintenance. Open source, no ads, donation-supported via optional Ko-fi in the footer.
Core Features
- Easter egg guides: Step-by-step guides for main quests, musical eggs, side eggs, and buildables across every Treyarch map (WAW through BO6/BO7). Users can check off steps and log full completions.
- Progress tracking: Log high rounds, challenge runs (No Downs, Pistol Only, Starting Room, etc.), and Easter egg completions. Everything rolls up into a profile with maps played, main EEs completed, average round, and achievement count.
- Leaderboards: Per-map leaderboards filtered by player count (Solo/Duo/Trio/Squad) and challenge type (Highest Round, No Downs, No Perks, etc.). See who's on top and where you rank.
- Find Group (LFG): Create listings (map, optional main quest EE, desired player count, platform, Discord/Steam/Xbox). Browse and filter listings; message creators via in-app chat. Listings expire after 30 days.
- Achievements & XP: Unlock achievements for round milestones, challenge completions, and Easter egg completions. Earn XP, level up, and display a rank (20 ranks from "Outbreak Survivor" to "Aether Overlord"). Rank icons on profiles and leaderboards.
- Proof-backed runs: Logs can include proof: YouTube or Twitch URL (embeddable), or screenshot. Optional completion time and notes.
- User profiles: Public/private, stats (maps played, main EEs completed, average round, achievements), recent logs, achievement grid with filters. Google sign-in only; post-login redirect to dashboard; settings (username, display name, bio, avatar, privacy).
Technical Highlights
Built with Next.js 14 (App Router), React 18, TypeScript, Tailwind CSS, Prisma ORM, PostgreSQL (Supabase), and Supabase Auth (Google OAuth). Hosted on Vercel. Key technical pieces:
- Large, structured EE content: step-by-step seed data for many maps, with challenges and achievements linked per map.
- Achievement system that evaluates criteria (round milestones, challenge type, EE completion) and grants XP/level in one flow; newly unlocked achievements returned for XP toasts.
- Find Group with listings and in-app messaging; only listing creator can edit/delete.
- EE step check-off synced per user; one-time XP for main quest completion via step tracker.
- 20-tier rank system with custom rank icons; optional Supabase Storage for assets.
Themed UI (dark, blood red / Element 115 accents, custom "zombies" font, optional TV-room background on home). Responsive layout, mobile-friendly nav and forms. SEO: metadata, Open Graph, Twitter cards, JSON-LD, canonical URLs, sitemap/robots. Custom domain (codzombiestracker.com).
Tech Stack
Next.js 14 (App Router, server components where used, API routes), TypeScript, React 18, Tailwind CSS, Framer Motion (animations), Lucide icons. Backend: Next.js API routes (serverless), Prisma ORM, PostgreSQL (Supabase). Auth: Supabase Auth (Google OAuth); session in cookies; custom "Sign in with Google" (no client-side Supabase auth UI). Zod used for validation. Hosting: Vercel; Supabase for DB + Auth.