ComposeNativeWebView is a Compose Multiplatform WebView whose API design and mobile implementations (Android & iOS) are intentionally derived almost verbatim from KevinnZou/compose-webview-multiplatform.

This project exists first and foremost to bring that same API to Desktop, backed by native OS webviews instead of a bundled Chromium runtime.

io.github.kdroidfilter.webview.*

🟢 Reused on purpose

• API surface (WebViewState, WebViewNavigator, settings, callbacks, mental model)
• Android implementation (android.webkit.WebView)
• iOS implementation (WKWebView)
• Overall behavior and semantics

👉 If you already know compose-webview-multiplatform, you already know how to use this.

🆕 What ComposeNativeWebView adds

• Desktop support with native engines
• A Rust + UniFFI (Wry) backend instead of KCEF / embedded Chromium
• A tiny desktop footprint with system-provided webviews

✅ Android: android.webkit.WebView ✅ iOS: WKWebView ✅ Desktop: Wry (Rust) via UniFFI

Desktop engines:

• Windows: WebView2
• macOS: WKWebView
• Linux: WebKitGTK

@Composable
fun App() {
  val state = rememberWebViewState("https://example.com")
  WebView(state, Modifier.fillMaxSize())
}

That’s it.

dependencies {
  implementation("io.github.kdroidfilter:composewebview:<version>")
}

Same artifact for Android, iOS, Desktop.

Wry uses native access via JNA.

compose.desktop {
  application {
    jvmArgs += "--enable-native-access=ALL-UNNAMED"
  }
}

Run the feature showcase first:

• Desktop: ./gradlew :demo:run
• Android: ./gradlew :demo-android:installDebug
• iOS: open iosApp/iosApp.xcodeproj in Xcode and Run

Responsive UI:

• large screens → side Tools panel
• phones → bottom sheet

• loadUrl(url, headers)
• loadHtml(html)
• loadHtmlFile(fileName, readType)

• navigateBack(), navigateForward()
• reload(), stopLoading()
• canGoBack, canGoForward

• isLoading
• loadingState
• lastLoadedUrl
• pageTitle

Unified cookie API:

state.cookieManager.setCookie(...)
state.cookieManager.getCookies(url)
state.cookieManager.removeCookies(url)
state.cookieManager.removeAllCookies()

navigator.evaluateJavaScript("document.title = 'Hello'")

• injected automatically after page load
• callback-based
• works on all platforms

window.kmpJsBridge.callNative("echo", {...}, callback)

Intercept navigator-initiated navigations only:

override fun onInterceptUrlRequest(
  request: WebRequest,
  navigator: WebViewNavigator
): WebRequestInterceptResult

Useful for:

• blocking URLs
• app-driven routing
• security rules

val state = rememberWebViewState(
  url = "https://example.com"
) {
  customUserAgentString = "MyApp/1.0"
}

Supports:

• URL
• inline HTML
• resource files

val navigator = rememberWebViewNavigator()
WebView(state, navigator)

Commands:

• loadUrl
• loadHtml
• loadHtmlFile
• evaluateJavaScript

state.webSettings.customUserAgentString = "MyApp/1.2.3"

Desktop note:

• applied at creation time
• changing it recreates the WebView (debounced)
• JS context/history may be lost

👉 Set it early.

state.webSettings.logSeverity = KLogSeverity.Debug

WebView(
  state,
  navigator,
  onCreated = { native ->
    println(native.getCurrentUrl())
  }
)

Useful for debugging or platform-specific hooks.

• wrywebview/ → Rust core + UniFFI bindings
• wrywebview-compose/ → Compose API
• demo-shared/ → shared demo UI
• demo/, demo-android/, iosApp/ → platform launchers

• RequestInterceptor does not intercept sub-resources
• Desktop UA change recreates the WebView

• API inspiration: KevinnZou/compose-webview-multiplatform
• Wry (Tauri ecosystem)
• UniFFI (Mozilla)