# Hextris

Hex puzzle, engine test for touch input (GPLv3 upstream).

```{raw} html
<a class="example-run-button" href="../demos/ports_hextris.html">▶ Run in browser</a>
<p><strong>Upstream:</strong> <a href="https://github.com/Hextris/hextris">https://github.com/Hextris/hextris</a></p>
```

**Tags:** `port` `tier-0`

# Hextris: SimVX port

Engine test only. Upstream is GPLv3, do **not** promote this to a SimVX example.

## Run (desktop)

```bash
uv run python ported_games/hextris/simvx_port/main.py
```

## Controls

- **Left arrow / A** rotate hex left
- **Right arrow / D** rotate hex right
- **Down / S** speed up falling blocks
- **Enter / R** restart (when game over)
- **Tap left half** rotate left (mouse + touch)
- **Tap right half** rotate right (mouse + touch)

## Web export (touch test)

```bash
uv run simvx export web ported_games/hextris/simvx_port/main.py \
    -o ported_games/hextris/simvx_port/web/index.html
```

Open `web/index.html` in Chrome 113+ or Edge 113+.

See `../NOTES.md` for the touch-input validation findings; that is the
headline of this port.

## Upstream

`../source/` is a shallow clone of https://github.com/Hextris/hextris (GPLv3).
JavaScript was used as a design reference; all Python here was written
from scratch.


## Source

```{literalinclude} ../../examples/ports/hextris/main.py
:language: python
:linenos:
```