Contribution Guide
How to contribute to the Ever Gauzy project.
Getting Started
- Fork the repository on GitHub
- Clone your fork locally
- Create a feature branch from
develop - Make your changes
- Submit a Pull Request
Development Setup
git clone https://github.com/YOUR_USERNAME/ever-gauzy.git
cd ever-gauzy
yarn install
yarn start:api # Terminal 1
yarn start # Terminal 2
Branch Naming
feature/SHORT-DESCRIPTION
bugfix/SHORT-DESCRIPTION
hotfix/SHORT-DESCRIPTION
docs/SHORT-DESCRIPTION
Commit Messages
Follow Conventional Commits:
feat: add employee avatar upload
fix: resolve time logging timezone bug
docs: add API quickstart tutorial
refactor: extract time service from controller
Pull Request Process
- Ensure CI passes (lint, test, build)
- Add/update tests for changes
- Update documentation if needed
- Request review from maintainers
- Address feedback
- PR is merged into
develop
Code Style
- Follow existing patterns
- Use TypeScript strict mode
- DTOs for all API input validation
- Multi-ORM decorators for entities
- Permissions guards on all endpoints
Areas for Contribution
| Area | Description |
|---|---|
| Bug fixes | Fix reported issues |
| Features | New features from roadmap |
| Documentation | Improve/add docs |
| i18n | Translation improvements |
| Tests | Add/improve test coverage |
| Performance | Optimization work |
Related Pages
- Git Workflow — branching model
- Code Review Checklist — PR review
- Development Guide — setup guide