Natrium

Natrium is a Kotlin Multiplatform library that wraps Wire's Kalium SDK to provide a simplified API for secure citizen-to-government communication.

Natrium is not a rewrite of Kalium. It is a thin facade that exposes only what partners need to build secure messaging clients.

Project Structure

natrium/
  natrium-core/     KMP library (the SDK) — see natrium-core/docs/ for SDK documentation
  natrium-cli/      JVM CLI app (Clikt), reference implementation

Targets

• JVM (desktop / server)
• Android (minSdk 26)
• iOS (arm64 + simulator)

All shared code lives in natrium-core/src/commonMain/ and must compile for all three targets.

Building

Prerequisites: JDK 17+, Android SDK (compileSdk 36).

# Build all targets
./gradlew build

Usage

Add natrium-core as a dependency from Maven Central:

// build.gradle.kts
dependencies {
    implementation("schwarz.opensource.natrium:natrium-core:<version>")
}

See natrium-core/README.md for API usage and code examples.

Documentation

• Getting Started — install, initialize, first login
• API Reference — full public-type and method listing

See natrium-core/README.md for the complete documentation index and design overview.

License

This project is licensed under the GNU General Public License v3.0. See LICENSE for details.