Contributing

Workflow

1. Fork / branch from main (feature/…, fix/…, docs/…)
2. Implement with tests where practical
3. Run locally:

dart format .
flutter analyze --no-pub
flutter test

1. Open a PR — CI runs analyze, test, and Android debug APK build

Commits

Conventional Commits:

feat: …
fix: …
docs: …
refactor: …
test: …
chore: …

Code style

See AGENTS.md — trailing commas, prefer_final_locals, single quotes, SizedBox for spacing, no drive-by refactors.

Docs site

Source lives in docs/. Pushes that touch docs deploy via GitHub Pages (.github/workflows/docs.yml).

Enable Pages in the repo: Settings → Pages → Source: GitHub Actions.

Agent skill

Shareable Cursor skill: .cursor/skills/nova-dev/SKILL.md.