AGENTS.md

1# AGENTS.md
2 
3This project is a Codename One cross-platform mobile app (Java 17 / Maven /
4ParparVM-iOS / Android / JavaScript / desktop). A vendor-neutral authoring skill
5is bundled in this repository for any AI agent:
6 
7- **Start here:** `.agent-skills/codename-one/SKILL.md`
8- **Topical references:** `.agent-skills/codename-one/references/`
9- **Runnable utilities (Java 17 single-file source mode):** `.agent-skills/codename-one/tools/`
10 
11Tool integrations (Claude Code, Cursor, etc.) may also pick this skill up via
12their own conventions; the canonical source of truth is `.agent-skills/`.
13 
14## Quick orientation for an agent
15 
16- App source lives in `common/src/main/java/`.
17- Theme/styling lives in `common/src/main/css/theme.css` (Codename One CSS — a
18  deliberate subset, see `.agent-skills/codename-one/references/css.md`).
19- Run the simulator with `mvn -pl common cn1:run`.
20- Run tests with `mvn -pl common cn1:test` (on Linux CI use `xvfb-run -a`).
21- Native cloud builds use `mvn -pl <ios|android|javascript|javase> package -Dcodename1.platform=... -Dcodename1.buildTarget=...`.
22 
23When in doubt, open `.agent-skills/codename-one/SKILL.md` and follow the
24reference table at the bottom.
25