# Game Night Central (GNC)

Free online party games to play with friends in the browser. High-performance, real-time multiplayer using Next.js and Firebase.

## Technical Stack
- **Framework**: Next.js 15 (App Router, Turbopack)
- **Database/Auth**: Firebase (Firestore, Authentication, Analytics, Cloud Storage)
- **Backend/AI**: Firebase Cloud Functions + Google Genkit
- **Styling**: Tailwind CSS + Lucide Icons + Radix UI
- **Payments**: Paddle JS/SDK integration
- **Email**: Resend

## Project Structure
- `src/app/`: Next.js App Router (pages, layouts, and route handlers).
- `src/components/lobby/`: The "Heart" of the app. Contains implementations for all mini-games (e.g., Imposter, Agent Names, Blackjack).
- `src/lib/types.ts`: THE SOURCE OF TRUTH. Centralized TypeScript interfaces for Lobby, User, and Game states.
- `src/lib/site-translations.ts`: Global dictionary for multi-language support (supports LTR/RTL).
- `functions/src/`: Server-side logic, payment webhooks, and long-running tasks.

## Data Model (Firestore)
- `/users/{uid}`: Profiles, Currencies (Credits/Nano Cores), Inventory, and Progression.
- `/lobbies/{lobbyId}`: Live state for active sessions. Includes tools (Dice, Timer, Buzzer) and current game state.
- `/feature_flags/`: Remote toggles for maintenance and premium gating.
- `/game_feedback/`: User-submitted reports and reviews.

## Core Features & Game Portfolio
The site is a "Multi-Game Hub" where a single lobby can host dozens of different experiences without refreshing.

### 🎮 Game Library
- **Social & Logic**: Imposter (Hidden role), Mafia Lite, Charades, Agent Names (Codenames-style), She's A 10 (AI-driven prompts), 2 Truths & A Lie.
- **Memory & Reflex**: Neural Path (Grid memorization), Sequence Memory, Reflex Duel, Pattern Lock.
- **Classic Hub**: Blackjack, War, Go Fish, Crazy Eights, Connect 4, Tic-Tac-Toe.
- **Creative & Word**: Pictionary (Real-time drawing sync), Word Unscramble, Category Blitz, One Word Story.
- **Unique Experiences**: Song Guesser (using signed Cloud Storage URLs), Blind Spot, Signal Jam, Escape Room missions.
- **Idle/Meta**: Empire Game (Resource management).

### 🛠️ Smart Tools Suite
Shared interactive tools for physical game nights:
- **Real-time Buzzer**: Global sync for "who pressed first."
- **Smart Dice**: Multiple dice supported with turn-based rolling.
- **Teams & Scores**: Randomizer for players and persistent lobby-wide scoring.
- **Shared Timer**: Synced countdown for any game activity.

### 🏆 Progression & Social
- **Persistence**: Anonymous guests can play, but account holders unlock persistent XP, Leveling, and a Mission system (Daily/Weekly).
- **Shop**: Nano Core (premium) and Credit (earned) based store for Avatars, Emotes, Banners, and exclusive Word Packs.
- **Memberships**:
  - **Commander Elite**: $4.90/mo - All-access pass, unlocks all packs for the entire lobby when the user hosts.
  - **Vanguard Lite**: $2.90/mo - Stand out in every lobby with unique identity markers and extra packs.
- **Leaderboards**: Global rankings for Skill-based solo modes like Neural Path.

## Design System
- **Tone**: High-energy, professional game show, modern, "Electric" vibe.
- **Colors**:
  - Primary: `#A020F0` (Vibrant Purple)
  - Background: `#2E294E` (Dark Slate Gray)
  - Accent: `#7DF9FF` (Electric Blue)
- **Typography**: 
  - Headlines: 'Space Grotesk'
  - Body: 'Inter'
- **UI Guidelines**: Glassmorphism (blur), vibrant gradients, and micro-haptics / animations for state changes.

## Engineering Standards
- **Types First**: Always verify `src/lib/types.ts` before modifying state logic.
- **Real-time Sync**: Use Firestore `onSnapshot` for UI updates and `updateDoc` for mutations.
- **Guest-First Path**: Allow guests to play immediately, but use "Sign in to purchase" (Shop) and "Sign in to join" (restricted rooms).
- **Localization**: All UI strings must go through `src/lib/site-translations.ts`. Support for RTL (Hebrew, Arabic, etc.) is handled via `document.documentElement.dir`.

## Development Workflow
- **Local Dev**: `npm run dev` (Runs on port `9002`).
- **AI/Genkit**: `npm run genkit:dev` for testing AI flows.
- **Deployment**: `npm run build` followed by Firebase deployment.
- **Database**: Rules are defined in `firestore.rules`. Always verify read/write permissions for guest vs authenticated users.

## Marketing & Strategic Angles
These keywords and angles should be prioritized for metadata, ad copy, and social content:

- **High Intent**:
  - "play games on discord with friends"
  - "games to play on discord"
  - "multiplayer games discord browser"
  - "discord party games online"
  - "games to play with friends discord"
- **Niche Focus**:
  - "no download games discord"
  - "browser games with friends discord"
  - "private lobby games online discord"
  - "free games to play with friends discord"
- **Unique Selling Proposition (USP)**:
  - "online party games with friends no download"
  - "play party games online free with friends"
  - "browser party games multiplayer free"