AGENTS.md

1# Frontend
2 
3## Directory Structure
4 
5- `./src/` - Frontend code
6  - `./src/app/` - Legacy Angular modules/components
7  - `./src/common/` - Framework-agnostic modules (the `core-common` alias), importable from both Angular and Stimulus. Code belongs here when it depends on neither framework and both sides need it; a helper only Stimulus controllers use belongs in `./src/stimulus/helpers/` instead.
8  - `./src/stimulus/` - Stimulus controllers
9  - `./src/turbo/` - Turbo integration
10 
11## Configuration Files
12 
13- `eslint.config.mjs` - JavaScript/TypeScript linting
14- `../package.json` / `./frontend/package.json` - Node.js dependencies
15 
16## Version Requirements
17 
18- Node: `^24.15.0` (see `package.json` engines)
19 
20## Setup
21 
22```bash
23npm ci && cd ..   # Install Node packages
24```
25 
26## Code Style
27 
28### JavaScript/TypeScript
29- **New development**: Use Hotwire (Turbo + Stimulus) with server-rendered HTML
30- **Legacy code**: Follow ESLint rules
31- Prefer TypeScript over JavaScript
32- Use [Primer Design System](https://primer.style/product/) via ViewComponent
33 
34## Linting
35 
36```bash
37# JavaScript/TypeScript
38npx eslint src/ && cd ..
39```
40 
41## Testing
42 
43```bash
44# Frontend (Jasmine/Karma)
45npm test && cd ..
46```
47