# Mafia Night

> A free online tool that helps groups play the Mafia party game in person. It handles role distribution digitally so the moderator doesn't have to whisper roles to each player individually.

## What It Does

Mafia Night is a web-based moderator assistant for the classic social deduction game "Mafia" (also known as Werewolf). The tool works entirely in-person — players physically gather together, but use their smartphones to receive secret role assignments privately.

The moderator (called "God" in traditional Mafia) creates a game session and gets a unique 6-digit code. Players join by entering that code on their own phones. The moderator configures how many Mafia members, Villagers, Doctors, Detectives, and other special roles to include. Roles are then assigned either randomly or manually. Each player views their role privately on their own device — no whispering, no shoulder-tapping, no accidental reveals.

## Who It's For

- Anyone hosting a Mafia or Werewolf game night
- Party hosts who want a fair, cheat-resistant role assignment method
- Groups of 4 to 20+ players
- Team-building events, college parties, family gatherings

## How to Play Mafia (Background)

Mafia is a social deduction game where players are secretly assigned to one of two teams:
- **Mafia** — a hidden minority who know each other and eliminate Villagers at night
- **Villagers** — the uninformed majority who must identify and eliminate Mafia members during the day

Special roles like Doctor (can save one player per night), Detective (can investigate one player per night), and others add strategic depth. The game alternates between "night" phases (Mafia acts secretly) and "day" phases (all players debate and vote to eliminate someone). Mafia wins when they equal or outnumber the Villagers. Villagers win when all Mafia are eliminated.

## Key Features

- Free to use, no account or download required
- 6-digit join codes for instant player onboarding
- Supports custom role configurations
- Random or manual role assignment
- Private role reveals per device
- Mobile-optimized for smartphones
- Sessions expire after 6 hours

## Pages

- `/` — Welcome page and game creation/joining
- `/about` — About the tool, features, and how to use it
- `/faq` — Frequently asked questions about Mafia Night and the Mafia game
- `/join` — Join an existing game by code
- `/game/:id/lobby` — Game lobby where players wait
- `/game/:id/setup` — Moderator configures roles
- `/game/:id/assign` — Role assignment screen
- `/game/:id/role` — Private role reveal for each player

## Technical Notes

- Built with React + TypeScript, hosted on Cloudflare Pages
- Real-time backend for session management
- No personal data stored; sessions are temporary