Connect-5 🎮

Premium Real-Time Multiplayer Gomoku Game

A beautiful, feature-rich implementation of the classic Connect-5 (Gomoku) game with real-time multiplayer support, built with modern web technologies.

Play Now • Features • Installation • Usage • Multiplayer • Deployment

---

✨ Features

🎯 Game Modes

• Local Play: Play against friends on the same device.
• Real-Time Multiplayer: Challenge players online with instant move synchronization.
• Multiple Board Sizes: Choose from 15×15, 20×20, 25×25, or 50×50 grids.

🏳️ Surrender & Rematch (NEW)

• Surrender Option: Realizing you're beaten? gracefully forfeit the game with the "Surrender" button to save time.
• Instant Rematch: After a game ends, challenge your opponent to a rematch instantly from the Game Over screen.
• Seamless Flow: Both players are kept in sync during surrender or rematch negotiations.

🛡️ Reliability (NEW)

• Smart Reconnects: If you lose internet or refresh the page, you are instantly placed back in your active game with the board restored.
• Game State Protection: No more abandoned games due to minor connection blips.
• Race Condition Handling: Robust server-logic preventing errors during rapid interactions.

🎨 Premium Design

• Graphing Paper Aesthetic: Beautiful dark theme with clean lines.
• Smooth Animations: Polished piece placement and victory effects.
• Glassmorphism UI: Modern, translucent interface elements.
• Responsive Design: Works seamlessly on desktop and mobile devices.

---

📸 Screenshots

Local Game Mode

Different Board Sizes

Victory Screen

(New screenshots for Surrender/Rematch UI coming soon)

---

🚀 Installation

Prerequisites

• Node.js 18+ (Download)
• PostgreSQL Database (Download)
• Git (Download)

Quick Start

# Clone the repository
git clone https://github.com/DeNNiiInc/Connect-5.git
cd Connect-5

# Install dependencies
npm install

# Configure database
# 1. Create database: CREATE DATABASE connect5;
# 2. Setup config:
cp db.config.example.js db.config.js
# 3. Edit db.config.js with your credentials

# 4. Initialize Database Schema
# (Check update-dbschema.js if psql is not available)
psql -h HOST -U postgres -d connect5 -f postgres-schema.sql

# Start the server
npm start

The server will start on http://localhost:3000

---

🎮 Usage

Multiplayer Instructions

1. Click "🌐 Multiplayer".
2. Enter your username (3-20 characters).
3. Lobby: See online players and their stats (Wins/Losses).
4. Challenge: Click "Challenge" next to a player.
5. Game On: Once accepted, the board loads for both of you.

In-Game Controls

• Place Piece: Click any empty intersection.
• Surrender: Click the "Surrender" button (Game Controls area) to forfeit.
• Rematch: After the game, click "Challenge Again" to keep playing the same opponent.

---

🚀 Production Deployment

We support Zero-Downtime Reliability and Auto-Start.

1. Automated Deployment

Use our deployment script to setup Nginx/Apache and Node.js automatically:

sudo bash deploy.sh

2. Auto-Start on Reboot (Systemd)

Never worry about server restarts again. Install the systemd service:

sudo bash setup-auto-start.sh

This ensures the app starts automatically and waits for the database to be ready.

3. Auto-Deploy (Git Hooks)

Enable automatic updates when you git pull:

bash setup-auto-deploy.sh

This installs a hook to restart the service automatically after code changes.

See DEPLOYMENT.md for full details.

---

🛠️ Tech Stack

Frontend

• HTML5/CSS3: Custom Glassmorphism design
• Vanilla JS: No frameworks, pure performance
• Socket.io Client: Real-time events

Backend

• Node.js + Express: Robust server
• Socket.io: WebSocket management
• PostgreSQL: Rigid data persistence (Players, Games, Moves, Sessions)

Database Schema

• Reliability First: Games are stored with status (active, completed, abandoned).
• Data Integrity: Players and Moves are linked via Foreign Keys.

---

🐛 Troubleshooting

Issue	Solution
Database Disconnected	Check db.config.js. If on production, run bash setup-auto-deploy.sh to fix sync issues.
"Function not found"	Run node update-dbschema.js to patch missing SQL functions.
Cannot Connect	Ensure port 3000 is open.

---

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

---

📧 Contact

Beyond Cloud Technology

• YouTube: @beyondcloudtechnology
• Repository: DeNNiiInc/Connect-5

Made with 💜 by Beyond Cloud Technology