Sign inSign up
sudoku-shift logo

hapheus/sudoku-shift

By hapheus

•Updated 7 minutes ago

Runnable Sudoku Shift container (Game Off 2026) with configurable Centrifugo WebSocket URL

Image
0

3.1K

hapheus/sudoku-shift repository overview

⁠Sudoku Shift

Runnable Docker container for Sudoku Shift — a zero-backend 9×9 and 6×6 Sudoku SPA with real-time Co-op and Spectator mode, built with React 19, Vite 8, and Nginx (port 8000).

Created for GitHub Game Off 2026⁠.

⁠Quick Start

Solo mode works out of the box. For live Co-op and Watch/Spectator mode, a Centrifugo v6 WebSocket server is required and can be passed directly via Docker environment variables.

⁠Single Container (with external Centrifugo)
docker run -d \
  --name sudoku-shift \
  -p 8000:8000 \
  -e WS_URL="wss://your-centrifugo-host/connection/websocket" \
  hapheus/sudoku-shift:latest

Then open http://localhost:8000.

⁠Docker Compose (App + Centrifugo v6)
services:
  app:
    image: hapheus/sudoku-shift:latest
    restart: unless-stopped
    ports:
      - "8000:8000"
    environment:
      WS_HOST: "localhost"
      WS_PORT: "8081"
      WS_SCHEME: "http"
      # Or set the full WebSocket URL directly:
      # WS_URL: "wss://sudoku-ws.example.com/connection/websocket"

  centrifugo:
    image: centrifugo/centrifugo:v6
    restart: unless-stopped
    ports:
      - "8081:8080"
    volumes:
      - ./docker/centrifugo/config.json:/centrifugo/config.json:ro
    environment:
      CENTRIFUGO_CLIENT_ALLOWED_ORIGINS: "*"

See docker/centrifugo/config.json⁠ in the repository for the required Centrifugo namespace configuration (sudoku and app).

⁠Environment Variables

At container startup, entrypoint.sh writes /usr/share/nginx/html/env-config.js so one image works across environments without rebuilding:

VariableDescriptionExample
WS_URLFull Centrifugo WebSocket endpoint (overrides WS_HOST/WS_PORT/WS_SCHEME)wss://sudoku-ws.example.com/connection/websocket
WS_HOSTCentrifugo hostnamelocalhost
WS_PORTCentrifugo port8081
WS_SCHEMEhttp (ws://) or https (wss://)https
PUBLIC_APP_URLOptional public base URL for share/invite linkshttps://sudoku.example.com

Tag summary

Content type

Image

Digest

sha256:fbd3574fb…

Size

66.1 MB

Last updated

7 minutes ago

docker pull hapheus/sudoku-shift