initial commit

Signed-off-by: ale <ale@manalejandro.com>

QUICKSTART.md

@@ -0,0 +1,109 @@
+# Quick Start Guide - Dominoes Online
+
+## 🚀 Get Started in 3 Steps
+
+### 1. Install Dependencies
+```bash
+npm install
+```
+
+### 2. Run Development Server
+```bash
+npm run dev
+```
+
+### 3. Open in Browser
+Visit **http://localhost:3000**
+
+---
+
+## 🎮 How to Play
+
+### Create a Game
+1. Enter your name
+2. Click "Create Room"
+3. Share the 6-digit room code with friends
+4. Click "Ready to Play" when everyone joins
+5. Game starts automatically!
+
+### Join a Game
+1. Enter your name
+2. Click "Join Room"
+3. Enter the room code from your friend
+4. Click "Ready to Play"
+5. Wait for game to start!
+
+### Play vs AI
+1. Enter your name
+2. Click "Play vs AI"
+3. Game starts immediately!
+
+---
+
+## 🎯 Game Controls
+
+### Your Turn
+1. **Click a tile** in your hand to select it
+2. **Click "Place Left"** or **"Place Right"** to place it
+3. Tiles must match the numbers on board ends
+
+### Can't Play?
+- **Click "Draw Tile"** to get a new tile from the boneyard
+- **Click "Pass Turn"** if no tiles left to draw
+
+### Board Navigation
+- **Click and drag** the board to pan around
+- View all placed tiles easily
+
+---
+
+## 🏆 Winning
+
+- First player to use all tiles wins!
+- If game is blocked (no one can move), lowest score wins
+- Score = sum of all remaining tile values
+
+---
+
+## 🎨 Features
+
+✅ Real-time multiplayer (2-4 players)  
+✅ AI opponent for solo play  
+✅ Beautiful Canvas graphics  
+✅ Smooth animations  
+✅ Mobile responsive  
+✅ Room-based games  
+
+---
+
+## 📝 Game Rules
+
+- 7 tiles per player at start
+- Match tile numbers to board ends
+- Draw if you can't play
+- Pass if boneyard is empty
+- Doubles can be placed either way
+
+---
+
+## 🔧 Commands
+
+```bash
+npm run dev      # Development server
+npm run build    # Build for production
+npm start        # Run production server
+npm run lint     # Check code quality
+```
+
+---
+
+## 🆘 Need Help?
+
+Check out:
+- **README.md** - Full project overview
+- **DOCUMENTATION.md** - Technical details
+- **GitHub Issues** - Report bugs or request features
+
+---
+
+**Enjoy playing dominoes! 🎲**