Skip-Bo Online

A modern implementation of the Skip-Bo card game, featuring real-time multiplayer gameplay. Built with FastAPI for the backend and SvelteKit + TypeScript for the frontend.

Features

• 🎮 Full Skip-Bo gameplay implementation
• 🎯 Real-time updates via WebSocket
• 👥 Support for 2-n players
• 🔒 Player-specific views
• 🎲 Drag-and-drop card interaction
• 🛠️ Debug view for game state inspection
• 🎨 Modern UI with Tailwind CSS
• 📱 Responsive design

Tech Stack

Backend

• FastAPI
• WebSocket
• Python 3.11+
• Pydantic for data validation

Frontend

• SvelteKit
• TypeScript
• Tailwind CSS
• Lucide Icons
• Axios for API calls

Getting Started

Prerequisites

• Python 3.11 or higher
• Node.js 16 or higher
• Yarn package manager

Installation

1. Clone the repository

Backend

1. python -m venv venv
2. pip install -r requirements.txt
3. uvicorn gui_main:app --host 0.0.0.0 --port 8000

Frontend

1. cd frontend
2. yarn install
3. yarn dev --host

Configuration

The game will be available at:

• Frontend: http://localhost:5173
• Backend API: http://localhost:8000
• API Documentation: http://localhost:8000/docs

TODO

• Add ability to see live where cards are currently dragged
• Bugfix: Replenish draw pile if 12th card is played on building pile
• Add ability to see cards below each other of discard pile by stacking them with just 80% overlap so the small number can be seen.
• Improve GUI as to not needing to scroll due to all the discard piles being on top of each other vertically
• Remove the redundant player info and add Player X's current hands as "facing down" cards, just like the draw pile card. Add info on whose turn it is somewhere else instead
• Add AI player
• Add Dark mode
• Add game restart functionality
• Add game sound effects