PavanRocks2045/Sequence
0
1---2title: Sequence3emoji: 🎴4colorFrom: purple5colorTo: blue6sdk: docker7app_port: 78608pinned: false9---10 11# 🎴 Sequence — Online Multiplayer Board Game12 13Play the classic **Sequence** board game online with friends! Create a room, share the link, and enjoy real-time multiplayer gameplay.14 15161718 19## ✨ Features20 21- **Real-time Multiplayer** — Play with friends via shareable room links22- **Up to 3 Teams** — Blue, Green, and Red teams with neon-glow chips23- **Private Hands** — Each player only sees their own cards24- **Full Board Visibility** — See all placed chips on the 10×10 board25- **No Turn Timer** — Play at your own pace26- **Card Shuffle Animation** — Gorgeous deck-shuffling animation on game start27- **Premium Dark UI** — Glassmorphism design with dark theme28- **Jack Mechanics** — Two-eyed jacks (wild) and one-eyed jacks (remove)29- **Sequence Detection** — Automatic win detection for 5-in-a-row30 31## 🚀 Quick Start (Local)32 33```bash34# Clone the repo35git clone https://github.com/Pavan20045/sequence.git36cd sequence37 38# Install dependencies39npm install40 41# Start the server42npm start43```44 45Open `http://localhost:3000` in your browser. Share the room code with friends!46 47## 🎯 How to Play48 491. **Create a Game** — Enter your name and click "Create Game"502. **Share the Room Code** — Send the code or link to friends513. **Choose Teams** — Each player selects Blue, Green, or Red524. **Start** — Host clicks "Start Game"535. **Play Cards** — Select a card from your hand, click the matching board space546. **Make Sequences** — Get 5 chips in a row (horizontal, vertical, or diagonal)557. **Win!** — First team to complete the required sequences wins!56 57### Special Cards58- **Two-Eyed Jacks (J♦, J♣)** — Wild! Place your chip on any empty space59- **One-Eyed Jacks (J♠, J♥)** — Remove an opponent's chip from the board60- **Corner Spaces** — Free for all teams (count toward any sequence)61 62## 📦 Deployment63 64### Vercel65 66```bash67# Install Vercel CLI68npm i -g vercel69 70# Deploy71vercel --prod72```73 74> **Note:** Vercel uses serverless functions. WebSocket support requires special configuration. For full real-time multiplayer, use a platform that supports persistent WebSocket connections (like Hugging Face Spaces, Railway, or Render).75 76### Hugging Face Spaces (Docker)77 781. Create a new Space on [Hugging Face](https://huggingface.co/new-space)792. Select **Docker** as the SDK803. Push this repo to the Space:81 82```bash83# Add HF remote84git remote add hf https://huggingface.co/spaces/PavanRocks2045/Sequence85 86# Push87git push hf main88```89 90The Dockerfile is pre-configured to use port 7860 (HF Spaces default).91 92### Railway / Render93 94Simply connect your GitHub repo — both platforms auto-detect Node.js projects.95 96## 🛠 Tech Stack97 98| Layer | Tech |99|-------|------|100| Server | Node.js + Express |101| Real-time | Socket.IO |102| Frontend | Vanilla HTML/CSS/JS |103| Styling | Custom CSS (Dark Glassmorphism) |104| Font | [Outfit](https://fonts.google.com/specimen/Outfit) |105 106## 📁 Project Structure107 108```109sequence-game/110├── server.js # Express + Socket.IO server111├── gameLogic.js # Core game logic (board, deck, sequences)112├── Dockerfile # Docker config for HF Spaces113├── vercel.json # Vercel deployment config114├── package.json115└── public/116 ├── index.html # Single-page app117 ├── css/118 │ └── style.css # Premium dark theme119 └── js/120 └── app.js # Client-side game logic121```122 123## 📜 License124 125MIT — Feel free to fork and modify!126