Contribute to OrionHealth

We welcome contributors of all skill levels! Whether you are fixing a typo, improving docs, or implementing a feature, your help is appreciated.

Quick Start

First, fork and clone the repository:

git clone https://github.com/YOUR_USERNAME/OrionHealth.git
cd OrionHealth
git remote add upstream https://github.com/iberi22/OrionHealth.git

Requirements: Flutter SDK 3.x, Android Studio or VS Code, Dart 3.x, Android SDK.

flutter pub get
flutter run

Branch Naming

• feat/your-feature-name
• fix/issue-number-description
• docs/update-documentation
• refactor/refactor-feature
• chore/update-dependencies

Commit Messages

Follow Conventional Commits: feat:, fix:, docs:, refactor:, chore:

Code Style

• 2-space indentation
• const where possible
• Type annotations for public APIs
• Doc comments for public methods

Pull Request Process

1. Keep PRs focused - one issue per PR
2. Update documentation if changing behavior
3. Add tests for new functionality
4. Follow code style conventions
5. Fill PR template

Security Guidelines

DO NOT create public GitHub issues for security vulnerabilities. Contact via GitHub Security Advisories.

• Never log sensitive data (PII, medical records)
• Use the encryption service for all sensitive data
• Validate all inputs

Code of Conduct

We follow the Contributor Covenant Code of Conduct. Be respectful, inclusive, and constructive.

First-Time Contributors

• Fix a typo in documentation
• Add an example to a doc page
• Review a simple PR
• Take a good first issue

Look for labels: good-first-issue, beginner-friendly, documentation.

Questions

• Check existing GitHub Issues
• Create a Discussion
• Read CONTRIBUTING.md

---

Thank you for contributing to OrionHealth!

Your contributions help people worldwide access their health data securely.