Splitties

Splitties is a collection of small Kotlin multiplatform libraries (with Android as first target).

These libraries are intended to reduce the amount of code you have to write, freeing code reading and writing time, so you can focus more on what you want to build for your users (even if you're the only one), or have more time to have fun.

This project is named "Splitties" because it is split in small modules, distributed as independent libraries, so you can add only the ones you need to your project/module, helping reduce the size of the final binary that users devices will need to download and keep in the limited storage (BTW, everything is limited).

Some Android targeting modules have a content similar to what Anko offers. See a short comparison of Splitties with Anko here.

Each module has been designed to have a small footprint and be as efficient as possible.

A few examples

Splitties is all about simplifying your code. Here are a few examples:

Kotlin:

startActivity(Intent(this, DemoActivity::class.java))

Kotlin with Splitties Activities:

start<DemoActivity>()

---

Kotlin:

Snackbar.make(root, R.string.refresh_successful, Snackbar.LENGTH_SHORT)
    .show()

Kotlin with Splitties Snackbar:

root.snack(R.string.refresh_successful)

---

Racing coroutines: (raceOf(…) comes from the Coroutines module)

suspend fun awaitUserChoice(ui: SomeUi, choices: List<Stuff>): Stuff? = raceOf({
    ui.awaitSomeUserAction(choices)
}, {
    ui.awaitDismissal()
    null
}, {
    ui.showSomethingInRealtimeUntilCancelled() // Returns Nothing, will run, but never "win".
})

---

Kotlin:

Snackbar.make(root, getString(R.string.deleted_x_items, deletedCount), Snackbar.LENGTH_LONG)
    .setAction(android.R.string.cancel) {
        deleteOperation.requestRollback()
    }
    .setActionTextColor(ContextCompat.getColor(this, R.color.fancy_color))
    .show()

Kotlin with Splitties Snackbar:

root.longSnack(str(R.string.deleted_x_items, deletedCount)) {
    action(android.R.string.cancel, textColor = color(R.color.fancy_color)) {
        deleteOperation.requestRollback()
    }
}

---

Overview

• System interaction (Android only)
• User input and user interface related splits
  • Small messages (Android only)
  • Dialogs (Android only)
  • System UI (Android only)
  • Extensions for Views (Android only)
  • Creating View based UIs with the power of Kotlin (Android only)
  • Various UI utilities (Android only)
  • Material Design helpers (Android only)
• Inter and cross app communication: Activities, Fragments, Intents, and Bundles
• Concurrency (Multiplatform)
• Data persistence (Multiplatform)
• Utilities (Multiplatform)
• Debugging (Android only)
• Legacy (Android only)

System interaction (Android only):

• App Context: Always have your application Context at hand with appCtx.
• System Services: No more context.getSystemService(NAME_OF_SERVICE) as NameOfManager.

User input and user interface related splits:

Small messages (Android only)

• Snackbar: Grab a snack without ceremony with snack(…) and longSnack(…).
• Toast: Show a toast by just calling toast(yourText), and dodge API 25 BadTokenException.

Dialogs (Android only)

• Alert Dialog: Create simple alert dialogs with simple code.
• Alert Dialog AppCompat: AppCompat version of Alert Dialog.
• Alert Dialog AppCompat Coroutines: showAndAwait extension functions for AppCompat AlertDialog.
• Alert Dialog Material: Material Components extension of Alert Dialog AppCompat.

System UI (Android only)

• Dangerous permissions: Request runtime permissions without polluting your codebase.

Extensions for Views (Android only)

• Views: Extensions function and properties on Views.
• Views AppCompat: AppCompat extension of Views. Includes helpers for ImageView tinting, ActionBar and tooltip.
• Views CardView: CardView extension of Views. Provides a contentPadding property.
• Views Material: Material Components extension of Views.
• Views Coroutines Material: Material Components + Kotlin coroutines.
• Views RecyclerView: RecyclerView extension of Views.
• Views Coroutines: Android Views + Kotlin coroutines.

Creating View based UIs with the power of Kotlin (Android only)

• Views DSL: Create UIs with readable Kotlin code (IDE preview supported).
• Views DSL AppCompat: AppCompat extension of Views DSL.
• Views DSL ConstraintLayout: ConstraintLayout extension of Views DSL.
• Views DSL CoordinatorLayout: CoordinatorLayout extension of Views DSL.
• Views DSL Material: Material Components extension of Views DSL.
• Views DSL RecyclerView: RecyclerView extension of Views DSL.

Various UI utilities (Android only)

• Resources: Extensions to get resources like strings, colors or drawables easily, with support for themed attributes.
• Dimensions: Android dp extensions for View and Context. Particularly handy when using Views DSL.
• Selectable views
  • Selectable Views: Selectable Views with foreground property before API 23.
  • Selectable Views AppCompat: Selectable Views for AppCompatTextView.
  • Selectable Views ConstraintLayout: Selectable Views for ConstraintLayout.
• Typesafe RecyclerView: Typesafe ViewHolder and ItemViewHolder for easy basic usage of RecyclerView.

Material Design helpers (Android only)

• Material Colors: 2014 Material Design color palettes as color resources.
• Material Lists: List item Views implementing Material Design guidelines (perfect for usage in a RecyclerView).

Inter and cross app communication: Activities, Fragments, Intents, and Bundles

• Activities: Start activities with minimal boilerplate.
• Intents: Transform companion objects into powerful typesafe intent specs, and create PendingIntents the clean and easy way.
• Fragments: Start activities from fragments and do transactions with minimal boilerplate.
• Fragment Args: Fragment arguments without ceremony thanks to delegated properties.
• Bundle: BundleSpec to use Bundle with property syntax for Intent extras and more.

Concurrency (Multiplatform)

• Coroutines: General purpose extensions to kotlinx.coroutines.
• Lifecycle Coroutines (Android only): Coroutines integration with AndroidX Lifecycle.
• Main Thread: Properties and precondition checkers related to the main thread.
• Main Handler (Android only): Top-level mainHandler property to stop allocating multiple Handlers for main Looper.
• Checked Lazy (Android only): mainThreadLazy that checks property access on

Data persistence (Multiplatform)

• Preferences: Property syntax for Android's SharedPreferences/DataStore and macOS/iOS/watchOS NSUserDefaults.
• Arch Room: Room helpers to instantiate your DB and perform transactions in Kotlin.

Utilities (Multiplatform)

• Bit Flags: hasFlag, withFlag and minusFlag extensions on Long, Int, Short, Byte, and their unsigned counterparts.
• Collections: forEach for Lists without Iterator allocation.

Debugging (Android only)

• Stetho init: Have Stetho for your debug builds, without writing any code!

Legacy (Android only)

• Exceptions: unexpectedValue(…), unsupportedAction(…) and similar functions that return Nothing.
• Arch Lifecycle: Extensions to get ViewModels, use LiveData and observe Lifecycles.

Download

Gradle instructions

Make sure you have mavenCentral() in the repositories defined in your project's (root) build.gradle file (default for new Android Studio projects).

To make it easier to take advantage of the contents of Splitties for your Android projects, there are grouping artifacts that include most splits.

Android base

Adding with refreshVersions: Splitties.pack.androidBase or Splitties.pack.androidBaseWithViewsDsl.

These 2 packs don't include AppCompat and are suitable for WearOS apps.

Includes the following modules:

• activities
• appctx
• bitflags
• bundle
• collections
• coroutines
• dimensions
• fragments
• fragmentargs
• intents
• lifecycle-coroutines
• mainhandler
• mainthread
• material-colors
• permissions
• preferences
• resources
• systemservices
• toast
• views
• views-coroutines
• views-recyclerview
• views-selectable
• views-selectable-constraintlayout

Gradle dependency:

implementation("com.louiscad.splitties:splitties-fun-pack-android-base:3.0.0")

There's also a version with Views DSL. It additionally includes the following modules:

• views-dsl
• [views-dsl-constrai