Folder When to use
feature New user-facing features and capabilities
fix Bug fixes, technical corrections, error handling
improvements
refactor Structural/code refactors without changing behavior
chore Auxiliary tasks: dependency updates, scripts, configs
hotfix Urgent production fixes (if your workflow mirrors git-flow)
test Integration tests, new test cases, snapshots, etc.
spike Research or temporary prototypes/experiments
perf Performance optimizations
docs Documentation additions or updates
build Build system, scripts, CI/CD pipelines
infra Infrastructure (e.g., Firebase setup, provisioning
profiles)
ci CI/CD-related configuration and scripts
deprecated Code/features marked for removal