arch-android

1.2.0indexed

Ergonomic toolkit for app architecture: state machines for view/scene orchestration, storage abstractions with persisted delegates, recycler utilities, foldable posture helpers and a lightweight context provider.

Android·matheus-corregiari/arch-android

Stars

—

Used by

dependents

—

Health

/ 100

Arch Android Toolkit

A Kotlin-first Android toolkit with APIs designed for Android source sets in KMP projects.

Lint Coverage

Features

State machines for view and scene orchestration.
Typed storage backed by memory, SharedPreferences, or encrypted SharedPreferences.
Property delegates for persisted values, extras, views, and ViewModels.
RecyclerView adapters, binders, and sticky headers.
Foldable layout helpers.
Application context provider.

Installation

kotlin {
    sourceSets {
        androidMain.dependencies {
            implementation("io.github.matheus-corregiari:arch-android:<latest-version>")
        }
    }
}

For an Android-only project:

dependencies {
    implementation("io.github.matheus-corregiari:arch-android:<latest-version>")
}

Usage

Initialize storage and the context provider from the application:

class App : Application() {
    override fun onCreate() {
        super.onCreate()
        Storage.KeyValue.init(this)
        ContextProvider.init(this)
    }
}

Create a view state machine:

val machine = ViewStateMachine()
machine.setup {
    state(0) {
        visibles(viewA)
        gones(viewB)
    }
    state(1) {
        visibles(viewB)
        gones(viewA)
    }
}
machine.changeState(0)

Persist a typed value:

val darkMode = ConfigValue(
    name = "dark_mode",
    default = false,
    storage = { Storage.KeyValue.regular },
)

darkMode.set(true)
val enabled = darkMode.get()