Skip to content

Aksara

Maven Central Latest tag License: MIT

Cross-platform live localization runtime for iOS & Android. One shared i18next-style JSON source of truth, over-the-air updates, O(1) lookup, and live SwiftUI / Jetpack Compose UI — with a mirrored Swift/Kotlin API kept in lockstep by mirrored tests.

Get started — iOS Get started — Android

Why Aksara

  • Over-the-air updates — ship new translations without an app-store release.
  • Bring your own transport — Aksara never fetches; you download bundles however you like and feed them in with applyBundle.
  • Pluggable parsing — a default i18next parser, or inject your own to accept any JSON model.
  • O(1) lookup — JSON is flattened to a hash map.
  • Live UI — language switches and applied updates update the visible UI in real time (SwiftUI and Jetpack Compose).
  • One source of truth — the same JSON on both platforms.
  • Safe swaps — every bundle is validated before it can replace the live table.

Install

// Package.swift
dependencies: [ .package(url: "https://github.com/iQbalADR/aksara.git", from: "0.2.0") ]

Also available via CocoaPods and Carthage — see iOS install.

dependencies {
    implementation("io.github.iqbaladr:aksara-core:0.2.0")
    implementation("io.github.iqbaladr:aksara-compose:0.2.0") // optional Compose bindings
}

Published to Maven Central — see Android install.

Quick look

import Aksara

Localizer.shared.configure(.init(
    defaultLanguage: "en", fallbackLanguage: "en", bundledResource: "en"
))
Localizer.shared.t("common.welcome", args: ["name": "Oncom"]) // "Welcome, Oncom!"
Localizer.shared.t("common.items", count: 3)                  // plural-aware
Localizer.shared.setLanguage("id")                            // live update

val loc = Localizer.instance

loc.configure(LocalizationConfig(
    defaultLanguage = "en", fallbackLanguage = "en", bundledResource = "en"
))
loc.t("common.welcome", mapOf("name" to "Oncom")) // "Welcome, Oncom!"
loc.t("common.items", count = 3)                   // plural-aware
loc.setLanguage("id")                              // live update

Same API, both platforms

Every public method exists with the same name and behavior on Swift and Kotlin, and both libraries ship with 47 matching unit tests.

Learn more