Volta is a powerful, reactive battery intelligence library for Kotlin Multiplatform (KMP) and Compose Multiplatform.

Monitor battery health, charging status, and advanced diagnostics across Android, iOS, and Desktop (Windows, macOS, Linux) with a single, unified API. Stop writing platform-specific code for battery monitoring and start using Volta.

• Unified KMP API: One interface for Android, iOS, and Desktop battery monitoring.
• Reactive State Management: Built on Kotlin StateFlow for seamless integration with modern UI architectures.
• Deep Battery Diagnostics: Access advanced data like Cycle Count, Current (mA), Voltage, Temperature, and Battery Technology.
• Smart Status Detection: Automatically detect Power Saving Mode, Safe Mode, and Protected Battery (80% limit) states.
• Compose Multiplatform Ready: Includes the rememberBatteryState() hook for instant UI updates.
• Lightweight & Native: Uses native system APIs (Android BatteryManager, iOS UIDevice, Windows WMIC, macOS pmset) for maximum efficiency.

Add Volta to your commonMain dependencies in your build.gradle.kts file:

commonMain.dependencies {
    implementation("io.github.techie-labs:volta:1.0.0-beta02")
}

Get reactive battery updates in your UI with just one line of code:

import androidx.compose.runtime.getValue
import io.techie.volta.rememberBatteryState

@Composable
fun BatteryDashboard() {
    val battery by rememberBatteryState()

    Column {
        Text("Battery Level: ${battery.level}%")
        Text("Charging Status: ${battery.chargingStatus}")

        if (battery.isPowerSavingMode) {
            Text("⚠️ Low Power Mode is ON")
        }
    }
}

Observe battery changes in your business logic:

class BatteryViewModel(private val batteryProvider: BatteryStateProvider) {
    init {
        batteryProvider.observe()
        
        viewModelScope.launch {
            batteryProvider.battery.collect { state ->
                println("Current Level: ${state.level}%")
            }
        }
    }
}

• Min SDK: 24 (Android 7.0)
• Permissions: Add <uses-permission android:name="android.permission.BATTERY_STATS" /> for full diagnostics.
• Note: Cycle Count requires Android 14+.

• Permissions: None required.
• Note: iOS limits access to hardware-level stats like temperature and voltage for third-party apps.

• Windows: Uses wmic and powercfg.
• macOS: Uses pmset and system_profiler.
• Linux: Reads from /sys/class/power_supply/.

Volta includes comprehensive unit tests for its core logic. The CI pipeline runs these tests on every push to ensure stability.

./gradlew allTests

Contributions are welcome! Please read our CONTRIBUTING.md to get started.

Volta is open-source software licensed under the Apache 2.0 License.

Built with ⚡ by Techie Labs