# Yuvomi Mobile

Independent native Android (Kotlin/Jetpack Compose) and iOS (SwiftUI) clients for
user-owned [Yuvomi](https://github.com/ulsklyc/yuvomi) servers. Not affiliated with
or endorsed by upstream.

**Native rebuild in progress — not full PWA parity or production-ready.**
The previous WebView wrapper did not meet the requested native implementation.
It is archived under `legacy/` and is not the shipped application surface.
Read the [feature-by-feature parity tracker](docs/native-parity.md) and
[current validation](docs/validation.md) before installing a preview.
No mobile backend, advertisements, telemetry, tracking, subscriptions, or mandatory cloud.
The apps render native controls and call the existing server API. The server owns
authorization, recurrence, synchronization and household business rules.

Use a root-hosted HTTPS instance with a valid certificate, including private servers
accessible through your VPN. Custom ports are supported. HTTP and subpath deployments
are intentionally rejected. Enter the server on first launch; use **Mehr** to
remove the native session and switch installations. The native client does not
import a browser/WebView session; sign in again after upgrading the prototype.

- [Architecture](docs/architecture.md)
- [Native preview delivery report](docs/native-delivery-report.md)
- [PWA design comparison and remaining differences](docs/native-design.md)
- [Android build](docs/build-android.md) / [iOS build](docs/build-ios.md)
- [Compatibility and authentication](docs/server-compatibility.md)
- [Release process](docs/release-process.md)
- [Gitea CI runners](docs/ci-runners.md)
- [Maintainer continuation](docs/continuation.md)

MIT licensed. Upstream notices are preserved in `THIRD_PARTY_NOTICES.md`.
This implementation is AI-assisted (OpenAI via OpenCode) and requires human security
review before release. No upstream modification or public submission is authorized.