`README.md`

27 lines
# sound.agentabrams.com — Agent Abrams SoundLab

Static sound/audio-toy hub, same setup as games.agentabrams.com: left panel lists
every build (`*.aa` names + icon), right panel runs the selected one in an iframe,
and each build can be popped **into its own window** (⧉). Zero dependencies, zero build.

Live target: https://sound.agentabrams.com (Kamatera, `/var/www/sound.agentabrams.com`, nginx static)

## Adding a sound build

1. Drop a self-contained build at `sounds/<id>/index.html` (must run standalone in an iframe).
2. Add its `<Name>.aa` marker in that folder, and an entry to `sound.json`:

```json
{ "id": "<id>", "file": "<Name>.aa", "icon": "🔊", "title": "...", "desc": "...", "path": "sounds/<id>/", "added": "YYYY-MM-DD" }
```

The hub auto-selects the last-opened build (localStorage) and supports `#<id>` deep links.
Every card opens in the embedded stage on click, or in its own window via the ⧉ pop-out.

## Deploy (Steve-gated)

```sh
deploy/deploy.sh        # first deploy: DNS + rsync + nginx + SSL
# updates: rsync -az --delete --exclude .git --exclude deploy ./ root@45.61.58.125:/var/www/sound.agentabrams.com/
```