Back to Projects
Interactive Criminal Profiling Game

Mug Matcher

An interactive detective skills game that challenges players to match mugshots with their corresponding crimes, combining visual recognition with criminal justice education.

Mug Matcher Game Interface

The Challenge

Traditional criminal justice education and detective training often rely on theoretical knowledge without practical application. Law enforcement professionals, criminology students, and true crime enthusiasts lack engaging, interactive tools to develop their visual recognition skills and understanding of criminal behavior patterns. The challenge was to create an educational yet entertaining platform that tests visual recognition abilities, builds understanding of crime categorization, provides immediate feedback, and remains engaging across multiple play sessions while working seamlessly across desktop and mobile devices.

The Solution

Mug Matcher is a web-based detective skills game that challenges players to match mugshots with their corresponding crimes. Built as a Progressive Web App using Next.js 15, the game combines visual recognition challenges with criminal justice education. Players are presented with 6 mugshots and 6 crime descriptions, testing their ability to make connections based on visual cues, crime patterns, and criminal profiling knowledge. The game features a sophisticated points system that rewards accuracy, speed, and consecutive correct matches, while providing detailed feedback to help players learn from their mistakes.

Key Features

  • Intelligent Crime Matching System with 400+ real criminal records
  • Smart crime categorization preventing similar offenses in single rounds
  • Sophisticated scoring system considering accuracy, speed, and attempt count
  • Real-time statistics with accuracy percentage and completion time tracking
  • Dual UI themes: Professional ShadCN and animated Aceternity interfaces
  • Progressive Web App with mobile-first responsive design and haptic feedback

Technical Implementation

Mug Matcher combines cutting-edge web technologies with sophisticated game mechanics:

Frontend Architecture

  • Next.js 15 with React 19 and TypeScript
  • Tailwind CSS with custom animations
  • Radix UI with ShadCN/UI and Aceternity UI
  • Framer Motion for smooth transitions

Backend & Data

  • Next.js API routes with error handling
  • CSV-based system with Papa Parse
  • Singleton pattern for in-memory caching
  • Multi-layer data validation
Game Interface with Mugshots
Crime Matching System

Project Details

My Role

Founder & Lead Developer

Timeline

6 weeks

Technologies

Next.js 15
React 19
TypeScript
Tailwind CSS
Framer Motion
Progressive Web App

Target Users

  • Law enforcement professionals seeking to sharpen visual recognition skills
  • Criminology students and educators needing interactive learning tools
  • True crime enthusiasts and gamers who enjoy detective work and puzzles

Monetization Ready

  • Integrated Buy Me A Coffee support
  • Google AdSense preparation with strategic ad zones
  • Built-in analytics hooks for user behavior tracking