Skip to content
Heatwave Docs

Commit Conventions

Conventional Commits style. The full list of types and common scopes used across the project.

Commit Types

Section titled “Commit Types”
  • feat: New features, icons, components, user-facing additions
  • fix: Bug fixes, build errors, broken functionality
  • refactor: Code restructuring, modernization, architectural changes
  • security: Security updates, vulnerability fixes
  • deps: Package updates, dependency management
  • chore: Maintenance, build improvements, tooling
  • perf: Performance improvements, optimizations

Common Scopes

Section titled “Common Scopes”
  • icons — Font Awesome related changes
  • build — Webpack, Babel, build system
  • deps — Package dependency updates
  • ui — User interface components
  • crm — CRM-specific functionality
  • www — WWW site functionality

Format

Section titled “Format”
<type>(<scope>): <description>


<body>


<footer>

Examples

Section titled “Examples”
feat(icons): add 13 missing Font Awesome 7 icons
security(deps): update deprecated Babel plugins
refactor(quote-builder): modernize from FA6 CSS to FA7 HTML
fix(build): resolve webpack compilation errors

Coding conventions

Section titled “Coding conventions”

Coding conventions live in the skills system, not here. See .agents/skills/ (also linked from CLAUDE.md) for canonical guidance on Ruby/Rails patterns, forms, view components, background jobs, etc.