<!-- Parent: ../AGENTS.md -->
<!-- Generated: 2026-07-02 | Updated: 2026-07-02 -->

# assets

## Purpose
Symfony AssetMapper source directory (Stimulus + Turbo scaffolding). **Largely unused in practice** — the real production CSS/JS is served from `public/styles/` and `public/scripts/`. Treat this as boilerplate unless you are intentionally migrating the frontend to AssetMapper/Stimulus.

## Key Files
| File | Description |
|------|-------------|
| `app.js` | AssetMapper entrypoint; imports `bootstrap.js` |
| `bootstrap.js` | Starts the Stimulus application, registers controllers from `controllers.json` |
| `controllers.json` | Third-party Stimulus controller registry |

## Subdirectories
| Directory | Purpose |
|-----------|---------|
| `controllers/` | Local Stimulus controllers (default stubs) (see `controllers/AGENTS.md`) |
| `styles/` | `app.css` — AssetMapper stylesheet (see `styles/AGENTS.md`) |
| `vendor/` | Vendored importmap JS packages (auto-managed, do not edit) |

## For AI Agents

### Working In This Directory
- Before adding here, check whether the feature should instead go in `public/scripts/` — that is where the live site's JS lives.
- Importmap entries are managed in root `importmap.php` via `php bin/console importmap:require`.

## Dependencies

### External
- `@hotwired/stimulus` 3.2.2, `@hotwired/turbo` 7.3.0, `@symfony/stimulus-bundle`.

<!-- MANUAL: -->
