ConnectivityKMP is a Kotlin Multiplatform library that provides a unified way to check network connectivity status across platforms with a Compose-first API.

It supports:

• ✅ Android
• ✅ iOS
• ✅ JVM/Desktop
• ✅ Web (Wasm/JS)

• 📱 Android – Uses ConnectivityManager callbacks to detect real-time connectivity changes.
• 🍏 iOS – Uses Apple’s nw_path_monitor for monitoring connectivity.
• 💻 JVM/Desktop – Fallback mechanism via socket reachability checks.
• 🌐 Web (Wasm/JS) – Detects online/offline using browser events (navigator.onLine).
• 🧩 Composable API – Exposes a simple rememberNetworkStatus() you can use anywhere in Compose.
• ⚡ Lightweight and dependency-free.

Add the dependency from Maven Central:

kotlin {
    sourceSets {
        commonMain.dependencies {
           implementation("io.github.khubaibkhan4:connectivity-kmp:0.0.2")
        }
    }
}

@Composable
fun App() {

   // get the Network Status
   val isNetworkAvailable by rememberNetworkStatus()
   
   // Network Status
   // NetworkStatus.Available, NetworkStatus.NoInternet, NetworkStatus.Lost, NetworkStatus.Unavailable, NetworkStatus.Slow


   Box(
      modifier = Modifier.fillMaxSize().background(Color.White),
      contentAlignment = Alignment.Center
   ) {
      if (isNetworkAvailable == NetworkStatus.Available){
         BasicText("Connected")
      } else {
         BasicText("Disconnected")
      }
   }
}

https://github.com/user-attachments/assets/a5a2251a-6ebe-422d-a928-4c216bb01269

https://github.com/user-attachments/assets/5aa984cf-93bf-4a86-b362-f511f3c19a04

• Desktop JVM: ./gradlew :sample:composeApp:run
• Android: open project in Android Studio and run the sample app
• iOS: open 'sample/iosApp/iosApp.xcodeproj' in Xcode and run the sample app
• Wasm: ./gradlew :sample:composeApp:wasmJsBrowserRun

1. Run ./gradlew :shared:publishToMavenLocal
2. Open ~/.m2/repository/my/connectivity/kmp/

1. Create an account and a namespace on Sonatype:
   https://central.sonatype.org/register/central-portal/#create-an-account
2. Add developer id, name, email and the project url to
   ./shared/build.gradle.kts
3. Generate a GPG key:
   https://getstream.io/blog/publishing-libraries-to-mavencentral-2021/#generating-a-gpg-key-pair

   gpg --full-gen-key
   gpg --keyserver keyserver.ubuntu.com --send-keys XXXXXXXX
   gpg --export-secret-key XXXXXXXX > XXXXXXXX.gpg
   

4. Add these lines to gradle.properties:

   signing.keyId=XXXXXXXX
   signing.password=[key password]
   signing.secretKeyRingFile=../XXXXXXXX.gpg
   mavenCentralUsername=[generated username]
   mavenCentralPassword=[generated password]
   

5. Run ./gradlew :shared:publishAndReleaseToMavenCentral --no-configuration-cache