Prefero is a modern, type-safe preferences library for Kotlin Multiplatform, built on top of AndroidX DataStore.

// build.gradle.kts
dependencies {
    implementation("dev.teogor.prefero:prefero-core:1.0.0-alpha02")
    ksp("dev.teogor.prefero:prefero-processor:1.0.0-alpha02")
}

Simply annotate your @Serializable data class. Prefero handles the rest.

@PreferoSchema
@Serializable
data class AppSettings(
    val theme: String = "light",
    @Encrypted val apiToken: String = ""
)

Prefero generates type-safe accessors, mapping your data class to DataStore keys automatically.

// Generated accessors
val settings = AppSettingsStore(dataStore)

// Reactive read
val currentTheme = settings.themeFlow.first()

// Type-safe write
settings.setTheme("dark")

• 🧩 KMP First: Identical API across Android, iOS (NSDocumentDirectory), Desktop (XDG), and Web.
• 🔐 Native Encryption: Built-in @Encrypted support using AES-GCM (Tink on Android, CryptoKit on iOS).
• 📝 Zero Boilerplate: KSP generates all Preferences.Key and Flow mapping logic for you.
• 🎨 Compose Integration: Auto-generates CompositionLocal and preview-friendly fakes.
• 🚀 Production Ready: Built-in support for migrations, debouncing, and remote configuration fallbacks.

Explore our structured guides for production setups:

• Architecture & Storage: Platform hooks and DataStore integration.
• Annotations Catalog: Detailed guide on @Encrypted, @Clamp, @Debounce, etc.
• Dependency Injection: Auto-generating Koin modules.
• UI & Testing: Compose integration and in-memory test fakes.
• Migrations & Remotes: Production data remapping and remote fallbacks.

Prefero is released under the MIT License.

Made with ♥ by @teogor