# Contributing {#contributing}


How to contribute to the Ever Gauzy project.


## Getting Started {#getting-started}


1. Fork the repository on GitHub
2. Clone your fork
3. Create a feature branch
4. Make changes
5. Run tests and lint
6. Submit a pull request


## Branch Naming {#branch-naming}


| Prefix      | Purpose          |
| ----------- | ---------------- |
| `feat/`     | New feature      |
| `fix/`      | Bug fix          |
| `docs/`     | Documentation    |
| `refactor/` | Code refactoring |
| `test/`     | Adding tests     |
| `chore/`    | Maintenance      |


## Commit Messages {#commit-messages}


Follow [Conventional Commits](https://www.conventionalcommits.org/):

```
feat(employee): add skill management endpoint
fix(time-tracking): resolve idle detection on macOS
docs(api): add pagination examples
refactor(core): simplify tenant filtering logic
```


## Pull Request Checklist {#pull-request-checklist}


- [ ] Code follows coding standards
- [ ] Tests added for new features
- [ ] Existing tests pass
- [ ] Lint passes
- [ ] Documentation updated
- [ ] PR description explains changes


## Development Workflow {#development-workflow}


```bash
# Create feature branch
git checkout -b feat/my-feature

# Make changes
# ...

# Run lint
yarn lint

# Run tests
yarn test

# Commit
git commit -m "feat(module): description"

# Push
git push origin feat/my-feature

# Create PR on GitHub
```


## Related Pages {#related-pages}


- [Development Guide](https://sourcey-gauzy.pages.dev/development/development-guide/index.md) — setup and tooling
- [Coding Standards](https://sourcey-gauzy.pages.dev/development/coding-standards/index.md) — code style
- [Testing](https://sourcey-gauzy.pages.dev/development/testing/index.md) — test strategies