Git Workflow & Branching Strategy
Git branching model and contribution workflow for Ever Gauzy.
Branching Modelโ
Branch Namingโ
| Branch Type | Pattern | Example |
|---|---|---|
| Feature | feature/{description} | feature/daily-plans |
| Bugfix | fix/{description} | fix/timer-not-stopping |
| Hotfix | hotfix/{description} | hotfix/security-patch |
| Release | release/{version} | release/1.5.0 |
| Documentation | docs/{description} | docs/api-reference |
Commit Messagesโ
Follow Conventional Commits:
feat(task): add daily plan feature
fix(timer): resolve timer not stopping on idle
docs(api): add employee endpoint docs
chore(deps): upgrade NestJS to v10
refactor(auth): simplify JWT validation
test(employee): add unit tests for employee service
Pull Request Processโ
- Create feature branch from
develop - Implement changes with tests
- Open PR targeting
develop - Wait for CI checks to pass
- Request review from 1-2 reviewers
- Address review comments
- Squash merge into
develop
CI Checksโ
| Check | Description |
|---|---|
| Build | yarn build succeeds |
| Lint | yarn lint passes |
| Unit Tests | yarn test passes |
| E2E Tests | Playwright tests pass |
| Code Coverage | Coverage meets threshold |
Related Pagesโ
- Contributing โ contribution guide
- Coding Standards โ code style
- Release Process โ how releases work