Initial commit

README.md

@@ -0,0 +1,51 @@
+🌐 [Português (BR)](README.pt_BR.md) | [Español](README.es.md)
+
+# Bingo Mixer
+
+Bingo Mixer is a social bingo game for in-person mixers. Find people who match the questions and get 5 in a row!
+
+📚 **[View Lab Guide](workshop/GUIDE.md)**
+🚀 **[Start with setup flow](workshop/01-setup.md)**
+
+---
+
+## 📚 Lab Guide
+
+| Part | Title |
+|------|-------|
+| [**00**](workshop/00-overview.md) | Overview & Checklist |
+| [**01**](workshop/01-setup.md) | Setup & Context Engineering |
+| [**02**](workshop/02-design.md) | Design-First Frontend |
+| [**03**](workshop/03-quiz-master.md) | Custom Quiz Master |
+| [**04**](workshop/04-multi-agent.md) | Multi-Agent Development |
+
+> 📝 Lab guides are also available in the [`workshop/`](workshop/) folder for offline reading.
+
+---
+
+## Prerequisites
+
+- [Node.js 22](https://nodejs.org/) or higher
+
+## Dev Container / Codespaces
+
+This repo already includes a `.devcontainer/devcontainer.json`.
+
+- **GitHub Codespaces:** create a Codespace from **your own repository** and it will use the devcontainer automatically.
+- **VS Code Dev Containers:** clone locally, then run `Dev Containers: Reopen in Container`.
+- **GitHub Pages publishing:** deployment is configured for your own repository.
+
+## Run
+
+```bash
+npm install
+npm run dev
+```
+
+## Build
+
+```bash
+npm run build
+```
+
+Deploys automatically to GitHub Pages on push to `main`.