---
title: "Contributing"
space: "CAMS Biometric Integration"
url: "https://docs.navari.co.ke/cams-biometric/contributing"
updated: "2026-05-27"
---

## Contributing

Contributions are welcome from the Frappe community.

### How to Contribute

1. Fork the repository at `https://github.com/navariltd/cams-biometric`
2. Create a feature or fix branch from `develop`:
  ```bash
  git checkout -b feat/my-feature develop
  ```
3. Follow [Conventional Commits](https://www.conventionalcommits.org/) format for your commit messages:
  - `feat: add multi-device support`
  - `fix: handle missing shift assignment gracefully`
  - `docs: update installation steps for v15`
4. Ensure pre-commit hooks pass before pushing:
  ```bash
  pre-commit run --all-files
  ```
5. Write or update tests in `test_cams_call.py`
6. Open a Pull Request targeting `develop`, with a clear description of what the PR does
7. Await review from the maintainer (`maniamartial`)

### Code Style

- Follow PEP 8 for Python
- Use `FrappeTestCase` for all tests
- Prefer real DB interactions in tests over heavy mocking
- All new features must include corresponding tests



### Reporting Issues

Open a GitHub issue at `https://github.com/navariltd/cams-biometric/issues`. Include:

- Your Frappe/ERPNext/HRMS version
- App version
- Steps to reproduce
- Error log output (redact AuthTokens before sharing)