-
-
Notifications
You must be signed in to change notification settings - Fork 1
Contributing
AstorisTheBrave edited this page Jul 4, 2026
·
1 revision
Contributions are welcome. The canonical guide is CONTRIBUTING.md in the repository; this page is a quick orientation.
- Search existing issues and discussions.
- For anything non-trivial, open an issue or discussion first so we can agree on the approach. Small fixes can go straight to a pull request.
- Please only submit code you understand and have actually run.
URSA follows viewer -> actions -> push. Read-heavy monitoring and reliability come first; broad configuration features are out of scope for now. If in doubt, ask.
- Kotlin and Jetpack Compose (Material 3). Match the existing style; do not restyle existing UI without discussion.
- Layered and reactive: keep Uptime Kuma's protocol quirks in the network adapter; repositories expose StateFlows; Compose renders them.
-
Conventional Commits (
feat:,fix:,chore:,docs:, ...). Releases and the changelog are generated from them. -
ASCII punctuation in committed files (use
-). Enable the shared hook:git config core.hooksPath scripts/hooks. -
Tests and lint must pass:
./gradlew :app:testDebugUnitTest :app:lintDebug.
Keep them focused (one logical change), fill in the template, and say how you tested it (including the device or emulator and Android version if UI is affected).
Do not open public issues for vulnerabilities. See the Security Policy and the Security summary.