# 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! 🎲**