clash

Cards (Ludicrous Ones) Against Humanity (CLASH) is an open‑source spin on Cards Against Humanity. Built in Rust and Svelte for offering a lightning‑fast online playground.

Getting Started

Prerequisites

• Rust (for the backend)
• Node.js & bun (for the frontend)

Installation

1. Clone the repo

git clone https://github.com/nwrenger/clash.git
cd clash

2. Backend (Rust)

# Firstly generate some certificates
./data/cert/gen.sh
# Run Debug Build with frontend build
cargo run -- localhost:8080 -f http://localhost:5173 --cache data/cache --cert data/cert/cert.pem --key data/cert/key.pem

The backend is also self-hosted at: https://api.clash.nwrenger.dev/

Command-line arguments:

3. Frontend (Svelte + Skeleton)

cd view
bun install
bun run dev

The frontend is also hosted on GitHub Pages: https://clash.nwrenger.dev/

Hosting & Scaling Limits

CLASH has been tested to handle up to 2–4 lobbies with 5,000 players each, or 10–30 lobbies with 1,000 players each, on typical modern server hardware (Oracle's Ampere A1 in free tier).

⚠️ Note: For very large lobbies (2,000+ players), browser performance becomes the primary bottleneck. Joining or updating lobbies with thousands of players can lag or freeze the UI, especially on lower-end devices.

Actual capacity will vary depending on server CPU/RAM, network bandwidth, and client performance.

We recommend keeping lobby sizes below 5,000 for the best experience.

Architecture

Backend (Rust)

• Endpoints:
  • [POST] /lobby — Creates a new lobby and returns its UUID.
  • [ANY] /ws/:lobby_id — WebSocket endpoint to join and interact with a lobby.
• Core: Game state managed in-memory, clients communicate via WebSockets.
• Server: Hosted centrally, responsible for message broadcasting and managing gameplay.

Frontend (Svelte + Skeleton)

• Framework: Svelte with Skeleton UI components.
• Features:
  • Create or join lobbies
  • General game loop with game over screen
  • Allowing custom decks from clrtd
  • Real‑time updates via WebSockets
  • Responsive design for desktop and mobile
• Deployment:
  • Hosted on GitHub Pages
  • Automatically rebuilt and published on every commit

Contributing & Issues

CLASH is in active beta. We welcome:

• Bug reports
• Feature requests
• Pull requests

Please open issues or PRs on GitHub.

License

This project is licensed under the MIT License. See LICENSE for details.