# Quantum Arcade

> Quantum Arcade is a gamified, interactive quantum computing simulator designed to teach quantum mechanics and quantum circuit development through hands-on simulations.

## Overview
Quantum Arcade enables students, developers, and researchers to build quantum circuits visually, test quantum gates, observe quantum states (such as superposition and quantum reversibility) in real-time, and track their quantum career progression.

## Key Modes & Features
- **Quantum Composer (/composer)**:
  - IBM Quantum Composer-style multi-qubit sandbox (2 to 6 qubits).
  - Place single-qubit gates (`H`, `X`, `Y`, `Z`, `S`, `T`) and multi-qubit entangling gates (`CNOT`, `CZ`, `SWAP`, `CCX` / Toffoli).
  - Live state vector calculation & probability distribution histogram ($|000\rangle \dots |111\rangle$).
  - 1024 Shots measurement simulation.
  - OpenQASM 2.0 export and live code generator.
  - Protocol presets: Bell State, GHZ 3-Qubit State, Superdense Coding, Quantum Teleportation, Grover's Search Step.
- **Arcade Missions (/dashboard)**:
  - Gamified level progression with missions, target state vectors, XP rewards, and victory conditions.
  - *Level 1: The Awakening* — Learn qubit excitation with the Pauli-X Gate.
  - *Level 2: The Uncertainty* — Achieve equal superposition with the Hadamard Gate.
  - *Level 3: The Stabilizer* — Understand quantum gate reversibility ($H \cdot H = I$) to return qubits to ground state.
- **Operator Dossier & Profile Customization (/profile)**:
  - Individual profile per user with customizable quantum avatar presets (Cyber Operator, Schrödinger's Cat, Qubit Pilot, Bloch Sentinel, Singularity Core, etc.) and Google profile picture support.
  - Custom callsign, operator title, bio, and quantum specializations.
  - Live XP level progression, career diagnostics, mission mastery tracking, and unlocked quantum achievement medals.
- **Real-Time Physics Engine**: Computes unitary matrices, state vectors, and wave function probabilities client-side with persistent Cloud Firestore synchronization.

## Core URLs
- [Quantum Arcade Homepage](https://quantum-arcade.web.app/): Overview, preview, and quantum computing introduction.
- [Quantum Composer Sandbox](https://quantum-arcade.web.app/composer): IBM-style multi-qubit circuit builder, state probabilities, and OpenQASM generator.
- [Arcade Missions Dashboard](https://quantum-arcade.web.app/dashboard): Gamified level progression and mission briefings.
- [Operator Profile Dossier](https://quantum-arcade.web.app/profile): Custom avatar picker, stats matrix, and achievement showcase.

## Technical Architecture
- **Framework**: Next.js 16 (React 19, TypeScript, Tailwind CSS)
- **Quantum Simulation Engine**: `quantum-circuit` (evaluates unitary matrix transformations and state vectors)
- **Hosting & Backend**: Firebase Hosting, Firebase Auth, Cloud Firestore
- **License**: Open & Free to explore