# CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

## Overview

Elden Ring-themed death counter for Schmendrizzle's Twitch stream. Originally a single standalone HTML file; now a Deno server with real-time multi-client WebSocket sync. Compiles to a self-contained Windows `.exe` via `deno compile`.

## File Structure

```
EldenRingCounter/
├── server.ts               # Deno HTTP + WebSocket server
├── desktop.html            # Main counter page with YOU DIED overlay
├── mobile.html             # Touch-optimized control page
├── obs.html                # Transparent browser source for OBS
├── Elden Ring Counter.html # Original standalone file (localStorage), kept for reference
└── .gitea/workflows/
    └── release.yml         # Builds and publishes Windows .exe on tag push
```

## Architecture

**`server.ts`** — Single `Deno.serve({ port: 8080 })` handling:
- `GET /` → `desktop.html`
- `GET /mobile` → `mobile.html`
- `GET /obs` → `obs.html`
- `GET /ws` (WebSocket upgrade) → real-time sync

State: single `deaths` variable in memory, broadcast to all clients on every mutation. Persisted to `counter.json` in cwd after each change; loaded on startup.

**WebSocket protocol:**
- Client → server: `{"action": "increment" | "decrement" | "reset"}`
- Server → all clients: `{"count": 42}`

**`desktop.html`** — Full counter UI. WebSocket client with auto-reconnect. YOU DIED overlay triggers when received count is higher than previous. Keyboard controls: `+`/`=`/`↑` increment, `-`/`_`/`↓` decrement, `R` reset.

**`mobile.html`** — Large touch buttons only. Same WebSocket client, no overlay.

**`obs.html`** — Fixed-size (`440×160px`) display box with transparent background. No controls, no status indicator.

## Key constraints

- Roman numeral display is capped at 3999 (`clamp(0, 3999)`); 0 displays as `—`.
- The overlay animation restarts cleanly via a forced reflow (`void overlay.offsetWidth`) before re-adding `.show`.
- UI language is German (`lang="de"`); string literals like `"Tode:"` are in German.
- `obs.html` has a fixed size so the layout never jumps as numbers grow.

## Commands

```bash
# Dev
deno run --allow-net --allow-read --allow-write server.ts

# Build Windows .exe
deno compile \
  --allow-net --allow-read --allow-write \
  --include desktop.html \
  --include mobile.html \
  --include obs.html \
  --target x86_64-pc-windows-msvc \
  --output elden-counter.exe \
  server.ts
```

## CI

`.gitea/workflows/release.yml` triggers on `v*` tags. Builds the Windows `.exe` and publishes it as a release asset via `softprops/action-gh-release`.