Contributing

Commit convention

Uses commitlint with this format:

type(scope): subject

Types: feat, fix, refactor, chore, ci, docs, revert, perf

Scopes: auth, profiles, tray, settings, ipc, ui, rust, timer

Subject: lower-case, max 72 characters

Examples

feat(auth): add auto-login on startup
fix(profiles): handle empty sso_session in chain resolution
refactor(ui): extract Tooltip into shared component

Pre-commit hooks

• Trailing whitespace removal
• End-of-file fixer
• Mixed-line-ending → LF
• No large files

PR workflow

1. Create a feature branch from main
2. Make changes
3. Run npm run lint, npm run typecheck, cargo check
4. Commit using the convention above
5. Push and open a PR