# ROM folder

## Shared (everyone)

1. Put the file in `public/roms/{system}/`
2. Add it to the shared catalog:

```bash
npm run add-shared -- --file=public/roms/nes/game.nes --title="Game" --system=nes --license="MIT" --source=https://…
```

Or use **Admin → Shared catalog** while `npm run dev` is running.

3. Commit `data/games.json` and the ROM so deploys include it for all visitors.

## Personal only (this machine)

Use `npm run scan-roms` / `npm run import-roms` — entries land in `data/user-games.json` and show under “Your games”.

Systems: `nes/`, `snes/`, `gb/`, `gbc/`, `gba/`, `genesis/`, `n64/`, `psx/`, `arcade/`, `nds/`, `psp/`, `sms/`, `gg/`, etc.