# UBGitea

Android client for the Ubisam Paju Gitea instance.

The application signs in with Gitea OAuth and lets employees browse repositories, branches, files, commit history and diffs, issues, pull requests and notifications. It is developed by Claude under the rules in `AGENTS.md`; every change goes through a task file under `tasks/` and is recorded in `docs/development-log.md`.

## Start here

1. Read `AGENTS.md`.
2. Read `docs/product.md` and `docs/architecture.md`.
3. Select or write one task under `tasks/`.
4. Record build and test evidence before marking the task complete.

OAuth uses Authorization Code with PKCE and does not use a client secret.

## Local checks

Open the repository root in Android Studio, or use JDK 17 or later with Android SDK 36 installed (Android Studio's bundled `jbr` works as `JAVA_HOME`) and run:

```text
./gradlew assembleDebug
./gradlew testDebugUnitTest
./gradlew lintDebug
```

The application uses ID `com.ubisam.ubgitea` and supports Android 9 (API 28) and later. See [ADR-001](docs/decisions/001-android-application-baseline.md).