> ## Documentation Index
> Fetch the complete documentation index at: https://docs.healthpush.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Contributing

> Development setup, testing workflow, and pull request conventions for HealthPush.

This page is for contributors. If you are trying to use the app, start with [Quickstart](/docs/quickstart) and the destination setup guides first.

## Development Setup

### iOS App

```bash theme={null}
git clone https://github.com/danburtenshaw/HealthPush.git
cd HealthPush/ios/HealthPush
brew install xcodegen
xcodegen
open HealthPush.xcodeproj
```

### Home Assistant Integration

```bash theme={null}
cd integrations/homeassistant
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements_test.txt
python -m pytest
```

## Working Rules

* Use Swift 6 with strict concurrency for the iOS app.
* Keep the iOS app free of third-party dependencies.
* Prefer reusable destination abstractions over destination-specific branching in shared code.
* Update tests and docs when behavior changes.
* Keep commit messages concise and imperative.

## Pull Requests

* Branch from `main`.
* Keep the PR focused on one feature or fix.
* Ensure tests pass locally before opening the PR.
* Update docs when setup, behavior, or public interfaces change.

## More Detail

* Full contributor guide: [CONTRIBUTING.md](https://github.com/danburtenshaw/HealthPush/blob/main/CONTRIBUTING.md)
* Repo-wide agent and architecture guidance: [AGENTS.md](https://github.com/danburtenshaw/HealthPush/blob/main/AGENTS.md)