---
name: luminous-plinko-board
description: Build a luminous pegboard physics experiment with moving light, circle collisions, adjustable launch position and outcome histograms.
---

# Let curiosity fall.

Build a luminous pegboard physics experiment with moving light, circle collisions, adjustable launch position and outcome histograms.

Generate a self-contained page with Python 3.10 or later, without dependencies:

```sh
python3 scripts/generate.py -o index.html
python3 scripts/generate.py -o index.html --title "Your playful experiment" --accent "#b5d8ff" --gravity 700
```

`--title` and `--subtitle` accept 1–2000 characters and render as plain text. `--accent` accepts a 3- or 6-digit hex color. `--gravity` accepts integers from 200 to 1400. A JSON configuration supplied with `--params` uses the same keys with underscores in place of hyphens. Output paths resolve from the caller's working directory; template paths resolve from this package.

Read [references/design.md](references/design.md) when adapting the interaction. Preserve its state transitions, actual result and keyboard path. The English interface runs offline. CSS honors reduced-motion preferences; user-triggered experiments remain available. Use `preview.html` for a working example.