# Imposter Game Word Generator - Full AI Documentation

> The ultimate browser-based Imposter Game (Spyfall alternative) toolkit. Instantly play social deduction word games with friends, family, or colleagues. Play for free at [ImposterGameWords.com](https://impostergamewords.com).

## 1. Project Overview
Imposter Game Word Generator is a digital facilitator for the popular offline social deduction party game. Instead of writing words on paper or downloading bulky apps, users simply open the website, select the number of players and imposters, pick a category, and hand the phone around.

The application is completely free, does not require account creation, and processes all game logic entirely on the client-side, ensuring data privacy and instant load times.

## 2. Core Game Rules (How to Play)
- **Setup:** The host selects the total number of players (3-10) and the number of Imposters (1-3), then chooses a word category (e.g., Kids, Couples, Hard).
- **Role Distribution (Pass & Play):** The device is passed around. Each player taps to reveal their secret role.
    - **Civilians:** Receive the exact same secret word (e.g., "Apple").
    - **Imposters:** Receive the word "IMPOSTER" (or a slightly different word in advanced modes).
- **Discussion:** Players take turns asking each other vague questions about the word to prove they are civilians without giving the word away to the Imposter.
- **Voting & Winning:**
    - Civilians win if they correctly identify and vote out the Imposter.
    - The Imposter wins if they survive the vote OR if they correctly guess the secret civilian word.

## 3. Game Categories & Word Lists
The platform provides an extensive, categorized database of balanced word pairs to ensure fair gameplay:
- **Standard/Normal:** Balanced difficulty for general groups.
- **Couples 18+:** Spicy, relationship-themed words for date nights or adult parties.
- **Kids & Family:** Simple, easily recognizable nouns (animals, school items, food) safe for children.
- **Foodie:** Culinary terms, dishes, and ingredients.
- **Hardcore (Expert):** Extremely similar concepts (e.g., "Ocean" vs "Sea", "Sofa" vs "Couch") that make bluffing incredibly difficult.
- **Español:** Fully localized Spanish words, designed for native speakers rather than simple translations.

## 4. Technical Architecture
- **Frontend Stack:** HTML5, JavaScript (Vanilla), Tailwind CSS.
- **Design System:** "Cyber" aesthetic featuring dark mode (`#0f172a`), neon green (`#39ff14`), and neon pink (`#ff00ff`) accents with glassmorphism UI components.
- **Build System:** Python-based custom static site generator (`build_pages.py`) combining JSON data sources with Jinja-like HTML templates.
- **SEO & AI Optimization:** Fully semantic HTML structure, strict canonical URLs, complete Schema.org GameApplication markup, and dedicated `llms.txt` routing for AI agents.

## 5. Educational and Professional Use
The tool is deliberately built as a lightweight web app so it can bypass strict school or corporate network filters (unblocked). It features dedicated facilitation guides specifically written for teachers running classroom activities and team leads hosting remote/Zoom icebreakers.

## 6. Contact & Support
- **Website:** [https://impostergamewords.com](https://impostergamewords.com)
- **All Guides and Articles:** [https://impostergamewords.com/resources](https://impostergamewords.com/resources)