Open Insurance Android

Android client for Open Insurance, built with Jetpack Compose and Material 3.

Features

• Material 3 theming with light/dark mode support
• Material You dynamic colors on Android 12+
• Edge-to-edge layout with system bar integration
• Email/password login against the Open Insurance identity API
• Client-side validation, loading state, and error handling

Requirements

• Android Studio Ladybug or newer
• JDK 11+
• Android SDK 36
• Minimum device API level: 26
• Running Open Insurance API / Kong gateway (for login)

Getting Started

Clone the repository and open the project in Android Studio.

git clone https://github.com/SudoCod/open-insurance-android.git
cd open-insurance-android

Create a local SDK path file (gitignored):

# local.properties
sdk.dir=/path/to/Android/Sdk

Build a debug APK from the command line:

./gradlew assembleDebug

Install and run on a connected device or emulator:

./gradlew installDebug

API Configuration

Login uses POST /identity/auth/login on the Kong gateway.

Field	Type	Notes
email	string	Required, email format
password	string	Required, min length 1

Successful responses return access_token, token_type (Bearer), and expires_in.

The default base URL in ApiClient is:

http://10.0.2.2:8000/

That maps the Android emulator to localhost:8000 on your machine. For a physical device, change ApiClient.BASE_URL to your host’s LAN address (for example http://192.168.x.x:8000/). Cleartext HTTP is allowed for local development hosts via network_security_config.xml.

Project Structure

app/
├── src/main/java/com/sudocod/openinsurance/
│   ├── MainActivity.kt
│   ├── data/
│   │   ├── auth/          # Login API, models, repository
│   │   └── network/       # Retrofit / OkHttp client
│   └── ui/
│       ├── login/         # Login screen + ViewModel
│       └── theme/         # Material 3 color schemes, typography, theme
└── src/main/res/
    ├── values/            # Light theme colors, strings, XML theme
    ├── values-night/      # Dark theme colors
    └── xml/               # Network security + backup rules

Tech Stack

Technology	Version
Kotlin	2.2.10
Android Gradle Plugin	9.3.0
Compose BOM	2026.02.01
Material Components	1.12.0
Retrofit	2.11.0
OkHttp	4.12.0
Kotlinx Serialization	1.8.0
Min SDK	26
Target SDK	36

Contributing

Contributions are welcome. Please read CONTRIBUTING.md before opening a pull request.

1. Fork the repository
2. Create a feature branch (git checkout -b feature/my-change)
3. Commit your changes with a clear message
4. Push to your fork and open a pull request

License

This project is licensed under the Apache License 2.0. See LICENSE for the full text.

Contributors

Made with contrib.rocks.