> ## Documentation Index
> Fetch the complete documentation index at: https://2026commitplusinc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Contributing

> How to build, test, and contribute to Commit+.

Commit+ is open source under the AGPLv3. Contributions are welcome.

## Start here

Use [Local Development](/docs/local-development) to set up the app, run the test suite, and preview the docs site.

## Build the app

```bash theme={null}
xcodebuild -project macgit.xcodeproj -scheme macgit -destination 'platform=macOS' build
```

## Test the app

```bash theme={null}
xcodebuild -project macgit.xcodeproj -scheme macgit -destination 'platform=macOS' test
```

Tests live in `macgitTests/` and use XCTest, creating real temporary Git repositories for integration tests.

## Style

* Follow existing Swift / SwiftUI conventions in the codebase.
* Keep changes focused and small enough to review.
* Keep docs aligned with shipped behavior. Use roadmap or planned language for future work.
* Preserve the lightweight Git core. Do not add runtime dependencies for Git workflows without a strong reason.
* Treat Sparkle as update infrastructure only, not as part of the repository workflow engine.
* Do not launch the app as a substitute for verification. Use `xcodebuild` build and test output as the baseline evidence.

## Docs changes

For docs-only changes in `docs-page/`:

```bash theme={null}
npm run lint
npm run broken-links
```