dominoes/QUICKSTART.md

Quick Start Guide - Dominoes Online

🚀 Get Started in 3 Steps

1. Install Dependencies

npm install

2. Run Development Server

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

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