Super Auto Pets: The Board Game — Online

A web app for playing the Super Auto Pets board game remotely. 1v1 for now; the engine is built to grow to more players.

Stack

• Backend: Go (stdlib-first). Pure game engine in internal/game, WebSocket sync via coder/websocket, persistence as JSON blobs in SQLite (modernc.org/sqlite, no cgo).
• Frontend: React + Vite + TypeScript in web/. DOM/CSS card rendering and battle animations.
• Tasks: mise (mise.toml).

Quick start

mise run install-web   # once: npm install
mise run serve         # build frontend + server, run on :8080

Open http://localhost:8080, host a game, and join from another browser (or incognito window) with the 5-letter code.

Development

mise run dev           # Go server on :8080 + Vite hot reload on :5173
mise run test          # Go tests (game engine)
mise run check         # go vet + frontend type-check

During development open the Vite URL (http://localhost:5173); it proxies /api (including the WebSocket) to the Go server.

Configuration

Set via environment or a .env file (see .env.example):

Variable	Default	Purpose
DATA_DIR	data	Directory holding the SQLite DB
PORT	8080	HTTP port
STATIC_DIR	web/dist	Built frontend to serve

Rules implemented

Six rounds, each with its own shop tier deck. Per round:

1. Shop — each player has 3 gold and players alternate actions, 1 gold each: buy one of 4 face-up cards; sell any number of hand cards (each becomes an 🍎 apple, +1 power food, and Sell effects fire); or trade in 3 same-suit pets (the Triple action) to pick 1 of the top 2 cards of the next tier's deck — Triple effects fire on the traded cards and the received pet's Buy effect fires. Passing forfeits remaining gold.
2. Cleanup — anyone holding more than 5 pets must sell down to 5.
3. Arrange — Battle Prep effects fire first (e.g. Giraffe hands out apples), then players secretly order their decks. Food cards apply to the next pet after them; trailing foods are wasted. A pet only benefits from its last-applied perk (e.g. Honey, Garlic).
4. Battle — automatic stack machine. Cards reveal off the top of each deck until a pet is in play. Play effects fire on reveal (rocks roll a d6 with faces 0/0/1/1/2/2 and hit the opposing pet before the clash). The two pets simultaneously deal their full power to each other as damage markers; a pet with markers ≥ power faints (attack never drops while wounded). Faint effects can push cards (apples, bees) onto either deck, recycle a pet's apples (Dodo), or set aside delayed rocks that hit BOTH active pets (Badger); survivors that took damage fire Hurt effects. Garlic prevents 1 damage from every attack that hits its pet — a clash that damages no one ends the battle as a stalemate draw. Last player able to field a pet wins: 1 trophy for rounds 1–5, 2 for round 6. Draws award nothing.

Apples and bees are temporary: they leave your deck after the battle. Most trophies after round 6 wins.

Tiers 1–3 use real card data (T1: Ant, Cricket, Duck, Otter, Mosquito, Fish; T2: Worm, Flamingo, Peacock, Swan, Rat, Spider + Honey; T3: Dog, Dolphin, Giraffe, Camel, Sheep, Dodo, Badger + Garlic). Tiers 4–6 are effect-less placeholders awaiting their real definitions.

Layout

cmd/server/          entrypoint
internal/game/       rules engine (pure, fully tested)
internal/server/     HTTP + WebSocket rooms
internal/store/      SQLite persistence
internal/env/        .env loading
web/                 React frontend