| name | git-and-commit-guidelines |
| description | Conventional Commits format, commit types, scopes, and PR best practices for Trezor Suite. Use when committing code or creating pull requests. |
Git and Commit Guidelines
IMPORTANT: This project uses Conventional Commits. All commits MUST follow this format:
<type>(<scope>): <description>
[optional body]
[optional footer]
Commit Types and Scopes
- feat: New feature (e.g.,
feat(suite): add transaction history export)
- fix: Bug fix (e.g.,
fix(components): resolve modal z-index issue)
- docs: Documentation changes (e.g.,
docs: update setup instructions)
- refactor: Code refactoring without behavior change
- test: Adding or updating tests
- chore: Build process, dependencies, tooling (e.g.,
chore(deps): update eslint)
Common scopes: suite, suite-native, connect, components, analytics
Commit Best Practices
- Plan internally, commit only code: For complex tasks, use todo lists or internal planning, but only commit actual code changes with conventional commits
- If you must commit intermediate work, use proper conventional commits (e.g.,
chore: work in progress on feature X) and be prepared to squash before final push
- Write clear, concise commit messages describing the actual change
- One logical change per commit when possible
- Reference issue numbers in commit body when applicable (e.g.,
Closes #1234)
- Avoid committing plan documents or TODO files unless they are part of the project documentation
Pull requests