Finish both-platform rendering, full component set, and Maven Central install

.editorconfig

@@ -10,6 +10,13 @@ trim_trailing_whitespace = true
 [*.{kt,kts}]
 indent_size = 4
 continuation_indent_size = 4
+ktlint_code_style = ktlint_official
+max_line_length = 140
+ktlint_standard_max-line-length = disabled
+ktlint_standard_function-signature = disabled
+# Compose @Composable functions use PascalCase by convention.
+ktlint_function_naming_ignore_when_annotated_with = Composable
+ktlint_standard_function-naming = disabled
 
 [*.{yml,yaml,json,md,xml}]
 indent_size = 2

.github/workflows/ci.yml

@@ -1,13 +1,35 @@
 name: CI
 
 on:
+ push:
+ branches: [main]
+ pull_request:
  workflow_dispatch:
 
 concurrency:
  group: ci-${{ github.ref }}
  cancel-in-progress: true
 
 jobs:
+ quality:
+ name: Quality gates
+ runs-on: macos-latest
+ steps:
+ - name: Check out code
+ uses: actions/checkout@v4
+
+ - name: Set up JDK
+ uses: actions/setup-java@v4
+ with:
+ distribution: zulu
+ java-version: 17
+
+ - name: Set up Gradle
+ uses: gradle/actions/setup-gradle@v4
+
+ - name: Spotless + Detekt + Kover
+ run: ./gradlew spotlessCheck detekt koverXmlReport koverVerify --stacktrace
+
  build:
  name: Build KMP targets
  runs-on: macos-latest
@@ -32,3 +54,6 @@ jobs:
 
  - name: Compile iOS sample
  run: ./gradlew :sampleApp:compileKotlinIosSimulatorArm64 --stacktrace
+
+ - name: Validate Maven publication
+ run: ./gradlew publishToMavenLocal --stacktrace

.github/workflows/docs.yml

@@ -0,0 +1,50 @@
+name: Deploy docs
+
+on:
+ push:
+ branches: [main]
+ paths:
+ - 'website/**'
+ - '.github/workflows/docs.yml'
+ workflow_dispatch:
+
+permissions:
+ contents: read
+ pages: write
+ id-token: write
+
+concurrency:
+ group: pages
+ cancel-in-progress: true
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ defaults:
+ run:
+ working-directory: website
+ steps:
+ - uses: actions/checkout@v4
+ - uses: pnpm/action-setup@v4
+ with:
+ version: 10
+ - uses: actions/setup-node@v4
+ with:
+ node-version: 20
+ cache: pnpm
+ cache-dependency-path: website/pnpm-lock.yaml
+ - run: pnpm install --frozen-lockfile
+ - run: pnpm build
+ - uses: actions/upload-pages-artifact@v3
+ with:
+ path: website/out
+
+ deploy:
+ needs: build
+ runs-on: ubuntu-latest
+ environment:
+ name: github-pages
+ url: ${{ steps.deployment.outputs.page_url }}
+ steps:
+ - id: deployment
+ uses: actions/deploy-pages@v5

.github/workflows/publish.yml

@@ -2,12 +2,15 @@ name: Publish
 
 on:
  release:
- types: [released]
+ types: [published]
  workflow_dispatch:
 
+permissions:
+ contents: read
+
 jobs:
  publish:
- name: Validate release publication
+ name: Publish to Maven Central
  runs-on: macos-latest
  steps:
  - name: Check out code
@@ -22,5 +25,14 @@ jobs:
  - name: Set up Gradle
  uses: gradle/actions/setup-gradle@v4
 
- - name: Build library publications
- run: ./gradlew :liquidkit:publishAllPublicationsToLocalBuildRepository :liquidkit-navigation3:publishAllPublicationsToLocalBuildRepository --stacktrace
+ - name: Verify before publishing
+ run: ./gradlew spotlessCheck detekt koverXmlReport --stacktrace
+
+ - name: Publish and release to Maven Central
+ run: ./gradlew publishAndReleaseToMavenCentral --no-configuration-cache --stacktrace
+ env:
+ ORG_GRADLE_PROJECT_mavenCentralUsername: ${{ secrets.MAVEN_CENTRAL_USERNAME }}
+ ORG_GRADLE_PROJECT_mavenCentralPassword: ${{ secrets.MAVEN_CENTRAL_PASSWORD }}
+ ORG_GRADLE_PROJECT_signingInMemoryKeyId: ${{ secrets.SIGNING_KEY_ID }}
+ ORG_GRADLE_PROJECT_signingInMemoryKey: ${{ secrets.SIGNING_KEY }}
+ ORG_GRADLE_PROJECT_signingInMemoryKeyPassword: ${{ secrets.SIGNING_PASSWORD }}

.gitignore

@@ -4,3 +4,6 @@
 /*/build/
 iosApp/DerivedData/
 local.properties
+
+.idea/
+xcuserdata/

README.md

@@ -1,27 +1,75 @@
-# LiquidGlass
+# LiquidKit
 
-LiquidGlass is a Kotlin Multiplatform component kit for Liquid Glass-style UI.
+LiquidKit is a Kotlin Multiplatform component kit for Liquid Glass-style UI.
 
-Android renders with the vendored AndroidLiquidGlass engine. iOS renders with
-native UIKit controls through Compose interop.
+One shared Compose Multiplatform API; the rendering diverges per platform:
 
-> Maven/module coordinates still use `liquidkit` until a deliberate breaking
-> rename is made.
+- **Android** renders the glass look in-Compose via an internal backdrop-capture
+ and refraction (Liquid Glass) shader engine.
+- **iOS** wraps **genuine native UIKit controls** (`UISwitch`, `UIButton` glass
+ configuration, `UIMenu`, `UIPickerView`, `UITextField`, `UISearchTextField`,
+ `UIStepper`, `UINavigationBar`, `UIVisualEffectView`) so components get the
+ authentic system Liquid Glass on iOS 26, with a `UIBlurEffect` `systemMaterial`
+ fallback on earlier versions.
+
+See [Architecture](#architecture) for details.
+
+## Install
+
+LiquidKit is published to Maven Central as `io.github.androidpoet`.
 
 ```kotlin
-io.github.androidpoet.liquidkit
-io.github.androidpoet.liquidkit.navigation3 // optional
+// build.gradle.kts (Kotlin Multiplatform)
+kotlin {
+ sourceSets {
+ commonMain.dependencies {
+ implementation("io.github.androidpoet:liquidkit:0.1.0")
+ // Optional Navigation 3 tab-stack helpers:
+ implementation("io.github.androidpoet:liquidkit-navigation3:0.1.0")
+ }
+ }
+}
 ```
 
+With a version catalog (`gradle/libs.versions.toml`):
+
+```toml
+[libraries]
+liquidkit = { module = "io.github.androidpoet:liquidkit", version = "0.1.0" }
+liquidkit-navigation3 = { module = "io.github.androidpoet:liquidkit-navigation3", version = "0.1.0" }
+```
+
+On iOS the library builds a static Kotlin/Native framework named `LiquidKit`
+(and `LiquidKitNavigation3` for the optional module); consume it the same way as
+any Compose Multiplatform framework embedded by your iOS app.
+
 ## Components
 
-- `LiquidToggle`
-- `LiquidSlider`
-- `LiquidSegmentedControl`
-- `LiquidBottomNavigation`
-- `LiquidTabScaffold`
+LiquidKit ships an iOS-parity component set:
+
+- `LiquidButton` (variants via `LiquidButtonVariant`) and `LiquidFab`
+- `LiquidSurface` and `LiquidGlassContainer`
+- `LiquidDropdownMenu` (`LiquidMenuItem`) and `LiquidPicker` (`LiquidPickerOption`)
+- `LiquidTextField` and `LiquidSearchField`
+- `LiquidStepper` and `LiquidMediaControl`
+- `LiquidToolbar` and `LiquidSheet`
+- `LiquidToggle`, `LiquidSlider`, `LiquidSegmentedControl`
+- `LiquidBottomNavigation` and `LiquidTabScaffold`
 - `LiquidNav3TabScaffold` from the optional Navigation 3 module
 
+## Architecture
+
+LiquidKit is a single cross-platform Compose API backed by `expect`/`actual`
+platform implementations:
+
+- **Android shader** — components render their Liquid Glass appearance with an
+ internal backdrop capture + refraction shader engine, entirely in Compose.
+- **iOS native** — components wrap real UIKit controls through Compose interop,
+ so they inherit the system's authentic Liquid Glass on iOS 26 (and degrade
+ gracefully to a `UIBlurEffect` `systemMaterial` on earlier iOS).
+
+You write one API; each platform draws it the right way.
+
 ## Controls
 
 ```kotlin
@@ -62,7 +110,7 @@ LiquidBottomNavigation(
 )
 ```
 
-Use `LiquidTabScaffold` when LiquidGlass should hold the selected tab:
+Use `LiquidTabScaffold` when LiquidKit should hold the selected tab:
 
 ```kotlin
 LiquidTabScaffold(items = items) { selectedTab ->
@@ -74,10 +122,21 @@ LiquidTabScaffold(items = items) { selectedTab ->
 }
 ```
 
+Hide or replace only the bottom bar when another shell owns it:
+
+```kotlin
+LiquidTabScaffold(
+ items = items,
+ bottomNavigation = { _, _ -> },
+) { selectedTab ->
+ TabContent(selectedTab)
+}
+```
+
 ## Navigation 3
 
 Use `liquidkit-navigation3` only for Compose-owned bottom-navigation tab stacks.
-LiquidGlass handles the multiple back stacks; your app still owns `NavDisplay`.
+LiquidKit handles the multiple back stacks; your app still owns `NavDisplay`.
 
 ```kotlin
 val state = rememberLiquidNav3State(
@@ -116,7 +175,8 @@ LiquidNav3TabScaffold(
 ```
 
 For native iOS 26 Liquid Glass tabs, keep `TabView` in SwiftUI and host Compose
-screens inside each tab.
+screens inside each tab. If you reuse a Compose tab scaffold there, pass an empty
+`bottomNavigation` slot so SwiftUI is the only tab bar.
 
 ## Build
 
@@ -138,7 +198,7 @@ iosApp/LiquidKitSample.xcodeproj
 
 ## Credits
 
-LiquidGlass's Android renderer includes source from
+LiquidKit's Android renderer includes source from
 [Kyant0/AndroidLiquidGlass](https://github.com/Kyant0/AndroidLiquidGlass).
 
 The optional Navigation 3 helper is adapted from the multiple-back-stack pattern

THIRD_PARTY_NOTICES.md

@@ -6,7 +6,7 @@ LiquidKit vendors Android Liquid Glass renderer and component source from:
 
 https://github.com/Kyant0/AndroidLiquidGlass
 
-Original author: Kyant
+Original author: Kyant
 License: Apache License 2.0
 
 The copied files live under:

.editorconfig

@@ -10,6 +10,13 @@ trim_trailing_whitespace = true
 [*.{kt,kts}]
 indent_size = 4
 continuation_indent_size = 4
+ktlint_code_style = ktlint_official
+max_line_length = 140
+ktlint_standard_max-line-length = disabled
+ktlint_standard_function-signature = disabled
+# Compose @Composable functions use PascalCase by convention.
+ktlint_function_naming_ignore_when_annotated_with = Composable
+ktlint_standard_function-naming = disabled
 
 [*.{yml,yaml,json,md,xml}]
 indent_size = 2

.github/workflows/ci.yml

@@ -1,13 +1,35 @@
 name: CI
 
 on:
+ push:
+ branches: [main]
+ pull_request:
  workflow_dispatch:
 
 concurrency:
  group: ci-${{ github.ref }}
  cancel-in-progress: true
 
 jobs:
+ quality:
+ name: Quality gates
+ runs-on: macos-latest
+ steps:
+ - name: Check out code
+ uses: actions/checkout@v4
+
+ - name: Set up JDK
+ uses: actions/setup-java@v4
+ with:
+ distribution: zulu
+ java-version: 17
+
+ - name: Set up Gradle
+ uses: gradle/actions/setup-gradle@v4
+
+ - name: Spotless + Detekt + Kover
+ run: ./gradlew spotlessCheck detekt koverXmlReport koverVerify --stacktrace
+
  build:
  name: Build KMP targets
  runs-on: macos-latest
@@ -32,3 +54,6 @@ jobs:
 
  - name: Compile iOS sample
  run: ./gradlew :sampleApp:compileKotlinIosSimulatorArm64 --stacktrace
+
+ - name: Validate Maven publication
+ run: ./gradlew publishToMavenLocal --stacktrace

.github/workflows/docs.yml

@@ -0,0 +1,50 @@
+name: Deploy docs
+
+on:
+ push:
+ branches: [main]
+ paths:
+ - 'website/**'
+ - '.github/workflows/docs.yml'
+ workflow_dispatch:
+
+permissions:
+ contents: read
+ pages: write
+ id-token: write
+
+concurrency:
+ group: pages
+ cancel-in-progress: true
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ defaults:
+ run:
+ working-directory: website
+ steps:
+ - uses: actions/checkout@v4
+ - uses: pnpm/action-setup@v4
+ with:
+ version: 10
+ - uses: actions/setup-node@v4
+ with:
+ node-version: 20
+ cache: pnpm
+ cache-dependency-path: website/pnpm-lock.yaml
+ - run: pnpm install --frozen-lockfile
+ - run: pnpm build
+ - uses: actions/upload-pages-artifact@v3
+ with:
+ path: website/out
+
+ deploy:
+ needs: build
+ runs-on: ubuntu-latest
+ environment:
+ name: github-pages
+ url: ${{ steps.deployment.outputs.page_url }}
+ steps:
+ - id: deployment
+ uses: actions/deploy-pages@v5

.github/workflows/publish.yml

@@ -2,12 +2,15 @@ name: Publish
 
 on:
  release:
- types: [released]
+ types: [published]
  workflow_dispatch:
 
+permissions:
+ contents: read
+
 jobs:
  publish:
- name: Validate release publication
+ name: Publish to Maven Central
  runs-on: macos-latest
  steps:
  - name: Check out code
@@ -22,5 +25,14 @@ jobs:
  - name: Set up Gradle
  uses: gradle/actions/setup-gradle@v4
 
- - name: Build library publications
- run: ./gradlew :liquidkit:publishAllPublicationsToLocalBuildRepository :liquidkit-navigation3:publishAllPublicationsToLocalBuildRepository --stacktrace
+ - name: Verify before publishing
+ run: ./gradlew spotlessCheck detekt koverXmlReport --stacktrace
+
+ - name: Publish and release to Maven Central
+ run: ./gradlew publishAndReleaseToMavenCentral --no-configuration-cache --stacktrace
+ env:
+ ORG_GRADLE_PROJECT_mavenCentralUsername: ${{ secrets.MAVEN_CENTRAL_USERNAME }}
+ ORG_GRADLE_PROJECT_mavenCentralPassword: ${{ secrets.MAVEN_CENTRAL_PASSWORD }}
+ ORG_GRADLE_PROJECT_signingInMemoryKeyId: ${{ secrets.SIGNING_KEY_ID }}
+ ORG_GRADLE_PROJECT_signingInMemoryKey: ${{ secrets.SIGNING_KEY }}
+ ORG_GRADLE_PROJECT_signingInMemoryKeyPassword: ${{ secrets.SIGNING_PASSWORD }}

.gitignore

@@ -4,3 +4,6 @@
 /*/build/
 iosApp/DerivedData/
 local.properties
+
+.idea/
+xcuserdata/

README.md

@@ -1,27 +1,75 @@
-# LiquidGlass
+# LiquidKit
 
-LiquidGlass is a Kotlin Multiplatform component kit for Liquid Glass-style UI.
+LiquidKit is a Kotlin Multiplatform component kit for Liquid Glass-style UI.
 
-Android renders with the vendored AndroidLiquidGlass engine. iOS renders with
-native UIKit controls through Compose interop.
+One shared Compose Multiplatform API; the rendering diverges per platform:
 
-> Maven/module coordinates still use `liquidkit` until a deliberate breaking
-> rename is made.
+- **Android** renders the glass look in-Compose via an internal backdrop-capture
+ and refraction (Liquid Glass) shader engine.
+- **iOS** wraps **genuine native UIKit controls** (`UISwitch`, `UIButton` glass
+ configuration, `UIMenu`, `UIPickerView`, `UITextField`, `UISearchTextField`,
+ `UIStepper`, `UINavigationBar`, `UIVisualEffectView`) so components get the
+ authentic system Liquid Glass on iOS 26, with a `UIBlurEffect` `systemMaterial`
+ fallback on earlier versions.
+
+See [Architecture](#architecture) for details.
+
+## Install
+
+LiquidKit is published to Maven Central as `io.github.androidpoet`.
 
 ```kotlin
-io.github.androidpoet.liquidkit
-io.github.androidpoet.liquidkit.navigation3 // optional
+// build.gradle.kts (Kotlin Multiplatform)
+kotlin {
+ sourceSets {
+ commonMain.dependencies {
+ implementation("io.github.androidpoet:liquidkit:0.1.0")
+ // Optional Navigation 3 tab-stack helpers:
+ implementation("io.github.androidpoet:liquidkit-navigation3:0.1.0")
+ }
+ }
+}
 ```
 
+With a version catalog (`gradle/libs.versions.toml`):
+
+```toml
+[libraries]
+liquidkit = { module = "io.github.androidpoet:liquidkit", version = "0.1.0" }
+liquidkit-navigation3 = { module = "io.github.androidpoet:liquidkit-navigation3", version = "0.1.0" }
+```
+
+On iOS the library builds a static Kotlin/Native framework named `LiquidKit`
+(and `LiquidKitNavigation3` for the optional module); consume it the same way as
+any Compose Multiplatform framework embedded by your iOS app.
+
 ## Components
 
-- `LiquidToggle`
-- `LiquidSlider`
-- `LiquidSegmentedControl`
-- `LiquidBottomNavigation`
-- `LiquidTabScaffold`
+LiquidKit ships an iOS-parity component set:
+
+- `LiquidButton` (variants via `LiquidButtonVariant`) and `LiquidFab`
+- `LiquidSurface` and `LiquidGlassContainer`
+- `LiquidDropdownMenu` (`LiquidMenuItem`) and `LiquidPicker` (`LiquidPickerOption`)
+- `LiquidTextField` and `LiquidSearchField`
+- `LiquidStepper` and `LiquidMediaControl`
+- `LiquidToolbar` and `LiquidSheet`
+- `LiquidToggle`, `LiquidSlider`, `LiquidSegmentedControl`
+- `LiquidBottomNavigation` and `LiquidTabScaffold`
 - `LiquidNav3TabScaffold` from the optional Navigation 3 module
 
+## Architecture
+
+LiquidKit is a single cross-platform Compose API backed by `expect`/`actual`
+platform implementations:
+
+- **Android shader** — components render their Liquid Glass appearance with an
+ internal backdrop capture + refraction shader engine, entirely in Compose.
+- **iOS native** — components wrap real UIKit controls through Compose interop,
+ so they inherit the system's authentic Liquid Glass on iOS 26 (and degrade
+ gracefully to a `UIBlurEffect` `systemMaterial` on earlier iOS).
+
+You write one API; each platform draws it the right way.
+
 ## Controls
 
 ```kotlin
@@ -62,7 +110,7 @@ LiquidBottomNavigation(
 )
 ```
 
-Use `LiquidTabScaffold` when LiquidGlass should hold the selected tab:
+Use `LiquidTabScaffold` when LiquidKit should hold the selected tab:
 
 ```kotlin
 LiquidTabScaffold(items = items) { selectedTab ->
@@ -74,10 +122,21 @@ LiquidTabScaffold(items = items) { selectedTab ->
 }
 ```
 
+Hide or replace only the bottom bar when another shell owns it:
+
+```kotlin
+LiquidTabScaffold(
+ items = items,
+ bottomNavigation = { _, _ -> },
+) { selectedTab ->
+ TabContent(selectedTab)
+}
+```
+
 ## Navigation 3
 
 Use `liquidkit-navigation3` only for Compose-owned bottom-navigation tab stacks.
-LiquidGlass handles the multiple back stacks; your app still owns `NavDisplay`.
+LiquidKit handles the multiple back stacks; your app still owns `NavDisplay`.
 
 ```kotlin
 val state = rememberLiquidNav3State(
@@ -116,7 +175,8 @@ LiquidNav3TabScaffold(
 ```
 
 For native iOS 26 Liquid Glass tabs, keep `TabView` in SwiftUI and host Compose
-screens inside each tab.
+screens inside each tab. If you reuse a Compose tab scaffold there, pass an empty
+`bottomNavigation` slot so SwiftUI is the only tab bar.
 
 ## Build
 
@@ -138,7 +198,7 @@ iosApp/LiquidKitSample.xcodeproj
 
 ## Credits
 
-LiquidGlass's Android renderer includes source from
+LiquidKit's Android renderer includes source from
 [Kyant0/AndroidLiquidGlass](https://github.com/Kyant0/AndroidLiquidGlass).
 
 The optional Navigation 3 helper is adapted from the multiple-back-stack pattern

THIRD_PARTY_NOTICES.md

@@ -6,7 +6,7 @@ LiquidKit vendors Android Liquid Glass renderer and component source from:
 
 https://github.com/Kyant0/AndroidLiquidGlass
 
-Original author: Kyant
+Original author: Kyant
 License: Apache License 2.0
 
 The copied files live under:

.editorconfig

@@ -10,6 +10,13 @@ trim_trailing_whitespace = true
 [*.{kt,kts}]
 indent_size = 4
 continuation_indent_size = 4
+ktlint_code_style = ktlint_official
+max_line_length = 140
+ktlint_standard_max-line-length = disabled
+ktlint_standard_function-signature = disabled
+# Compose @Composable functions use PascalCase by convention.
+ktlint_function_naming_ignore_when_annotated_with = Composable
+ktlint_standard_function-naming = disabled
 
 [*.{yml,yaml,json,md,xml}]
 indent_size = 2

.github/workflows/ci.yml

@@ -1,13 +1,35 @@
 name: CI
 
 on:
+ push:
+ branches: [main]
+ pull_request:
  workflow_dispatch:
 
 concurrency:
  group: ci-${{ github.ref }}
  cancel-in-progress: true
 
 jobs:
+ quality:
+ name: Quality gates
+ runs-on: macos-latest
+ steps:
+ - name: Check out code
+ uses: actions/checkout@v4
+
+ - name: Set up JDK
+ uses: actions/setup-java@v4
+ with:
+ distribution: zulu
+ java-version: 17
+
+ - name: Set up Gradle
+ uses: gradle/actions/setup-gradle@v4
+
+ - name: Spotless + Detekt + Kover
+ run: ./gradlew spotlessCheck detekt koverXmlReport koverVerify --stacktrace
+
  build:
  name: Build KMP targets
  runs-on: macos-latest
@@ -32,3 +54,6 @@ jobs:
 
  - name: Compile iOS sample
  run: ./gradlew :sampleApp:compileKotlinIosSimulatorArm64 --stacktrace
+
+ - name: Validate Maven publication
+ run: ./gradlew publishToMavenLocal --stacktrace

.github/workflows/docs.yml

@@ -0,0 +1,50 @@
+name: Deploy docs
+
+on:
+ push:
+ branches: [main]
+ paths:
+ - 'website/**'
+ - '.github/workflows/docs.yml'
+ workflow_dispatch:
+
+permissions:
+ contents: read
+ pages: write
+ id-token: write
+
+concurrency:
+ group: pages
+ cancel-in-progress: true
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ defaults:
+ run:
+ working-directory: website
+ steps:
+ - uses: actions/checkout@v4
+ - uses: pnpm/action-setup@v4
+ with:
+ version: 10
+ - uses: actions/setup-node@v4
+ with:
+ node-version: 20
+ cache: pnpm
+ cache-dependency-path: website/pnpm-lock.yaml
+ - run: pnpm install --frozen-lockfile
+ - run: pnpm build
+ - uses: actions/upload-pages-artifact@v3
+ with:
+ path: website/out
+
+ deploy:
+ needs: build
+ runs-on: ubuntu-latest
+ environment:
+ name: github-pages
+ url: ${{ steps.deployment.outputs.page_url }}
+ steps:
+ - id: deployment
+ uses: actions/deploy-pages@v5

.github/workflows/publish.yml

@@ -2,12 +2,15 @@ name: Publish
 
 on:
  release:
- types: [released]
+ types: [published]
  workflow_dispatch:
 
+permissions:
+ contents: read
+
 jobs:
  publish:
- name: Validate release publication
+ name: Publish to Maven Central
  runs-on: macos-latest
  steps:
  - name: Check out code
@@ -22,5 +25,14 @@ jobs:
  - name: Set up Gradle
  uses: gradle/actions/setup-gradle@v4
 
- - name: Build library publications
- run: ./gradlew :liquidkit:publishAllPublicationsToLocalBuildRepository :liquidkit-navigation3:publishAllPublicationsToLocalBuildRepository --stacktrace
+ - name: Verify before publishing
+ run: ./gradlew spotlessCheck detekt koverXmlReport --stacktrace
+
+ - name: Publish and release to Maven Central
+ run: ./gradlew publishAndReleaseToMavenCentral --no-configuration-cache --stacktrace
+ env:
+ ORG_GRADLE_PROJECT_mavenCentralUsername: ${{ secrets.MAVEN_CENTRAL_USERNAME }}
+ ORG_GRADLE_PROJECT_mavenCentralPassword: ${{ secrets.MAVEN_CENTRAL_PASSWORD }}
+ ORG_GRADLE_PROJECT_signingInMemoryKeyId: ${{ secrets.SIGNING_KEY_ID }}
+ ORG_GRADLE_PROJECT_signingInMemoryKey: ${{ secrets.SIGNING_KEY }}
+ ORG_GRADLE_PROJECT_signingInMemoryKeyPassword: ${{ secrets.SIGNING_PASSWORD }}

.gitignore

@@ -4,3 +4,6 @@
 /*/build/
 iosApp/DerivedData/
 local.properties
+
+.idea/
+xcuserdata/

README.md

@@ -1,27 +1,75 @@
-# LiquidGlass
+# LiquidKit
 
-LiquidGlass is a Kotlin Multiplatform component kit for Liquid Glass-style UI.
+LiquidKit is a Kotlin Multiplatform component kit for Liquid Glass-style UI.
 
-Android renders with the vendored AndroidLiquidGlass engine. iOS renders with
-native UIKit controls through Compose interop.
+One shared Compose Multiplatform API; the rendering diverges per platform:
 
-> Maven/module coordinates still use `liquidkit` until a deliberate breaking
-> rename is made.
+- **Android** renders the glass look in-Compose via an internal backdrop-capture
+ and refraction (Liquid Glass) shader engine.
+- **iOS** wraps **genuine native UIKit controls** (`UISwitch`, `UIButton` glass
+ configuration, `UIMenu`, `UIPickerView`, `UITextField`, `UISearchTextField`,
+ `UIStepper`, `UINavigationBar`, `UIVisualEffectView`) so components get the
+ authentic system Liquid Glass on iOS 26, with a `UIBlurEffect` `systemMaterial`
+ fallback on earlier versions.
+
+See [Architecture](#architecture) for details.
+
+## Install
+
+LiquidKit is published to Maven Central as `io.github.androidpoet`.
 
 ```kotlin
-io.github.androidpoet.liquidkit
-io.github.androidpoet.liquidkit.navigation3 // optional
+// build.gradle.kts (Kotlin Multiplatform)
+kotlin {
+ sourceSets {
+ commonMain.dependencies {
+ implementation("io.github.androidpoet:liquidkit:0.1.0")
+ // Optional Navigation 3 tab-stack helpers:
+ implementation("io.github.androidpoet:liquidkit-navigation3:0.1.0")
+ }
+ }
+}
 ```
 
+With a version catalog (`gradle/libs.versions.toml`):
+
+```toml
+[libraries]
+liquidkit = { module = "io.github.androidpoet:liquidkit", version = "0.1.0" }
+liquidkit-navigation3 = { module = "io.github.androidpoet:liquidkit-navigation3", version = "0.1.0" }
+```
+
+On iOS the library builds a static Kotlin/Native framework named `LiquidKit`
+(and `LiquidKitNavigation3` for the optional module); consume it the same way as
+any Compose Multiplatform framework embedded by your iOS app.
+
 ## Components
 
-- `LiquidToggle`
-- `LiquidSlider`
-- `LiquidSegmentedControl`
-- `LiquidBottomNavigation`
-- `LiquidTabScaffold`
+LiquidKit ships an iOS-parity component set:
+
+- `LiquidButton` (variants via `LiquidButtonVariant`) and `LiquidFab`
+- `LiquidSurface` and `LiquidGlassContainer`
+- `LiquidDropdownMenu` (`LiquidMenuItem`) and `LiquidPicker` (`LiquidPickerOption`)
+- `LiquidTextField` and `LiquidSearchField`
+- `LiquidStepper` and `LiquidMediaControl`
+- `LiquidToolbar` and `LiquidSheet`
+- `LiquidToggle`, `LiquidSlider`, `LiquidSegmentedControl`
+- `LiquidBottomNavigation` and `LiquidTabScaffold`
 - `LiquidNav3TabScaffold` from the optional Navigation 3 module
 
+## Architecture
+
+LiquidKit is a single cross-platform Compose API backed by `expect`/`actual`
+platform implementations:
+
+- **Android shader** — components render their Liquid Glass appearance with an
+ internal backdrop capture + refraction shader engine, entirely in Compose.
+- **iOS native** — components wrap real UIKit controls through Compose interop,
+ so they inherit the system's authentic Liquid Glass on iOS 26 (and degrade
+ gracefully to a `UIBlurEffect` `systemMaterial` on earlier iOS).
+
+You write one API; each platform draws it the right way.
+
 ## Controls
 
 ```kotlin
@@ -62,7 +110,7 @@ LiquidBottomNavigation(
 )
 ```
 
-Use `LiquidTabScaffold` when LiquidGlass should hold the selected tab:
+Use `LiquidTabScaffold` when LiquidKit should hold the selected tab:
 
 ```kotlin
 LiquidTabScaffold(items = items) { selectedTab ->
@@ -74,10 +122,21 @@ LiquidTabScaffold(items = items) { selectedTab ->
 }
 ```
 
+Hide or replace only the bottom bar when another shell owns it:
+
+```kotlin
+LiquidTabScaffold(
+ items = items,
+ bottomNavigation = { _, _ -> },
+) { selectedTab ->
+ TabContent(selectedTab)
+}
+```
+
 ## Navigation 3
 
 Use `liquidkit-navigation3` only for Compose-owned bottom-navigation tab stacks.
-LiquidGlass handles the multiple back stacks; your app still owns `NavDisplay`.
+LiquidKit handles the multiple back stacks; your app still owns `NavDisplay`.
 
 ```kotlin
 val state = rememberLiquidNav3State(
@@ -116,7 +175,8 @@ LiquidNav3TabScaffold(
 ```
 
 For native iOS 26 Liquid Glass tabs, keep `TabView` in SwiftUI and host Compose
-screens inside each tab.
+screens inside each tab. If you reuse a Compose tab scaffold there, pass an empty
+`bottomNavigation` slot so SwiftUI is the only tab bar.
 
 ## Build
 
@@ -138,7 +198,7 @@ iosApp/LiquidKitSample.xcodeproj
 
 ## Credits
 
-LiquidGlass's Android renderer includes source from
+LiquidKit's Android renderer includes source from
 [Kyant0/AndroidLiquidGlass](https://github.com/Kyant0/AndroidLiquidGlass).
 
 The optional Navigation 3 helper is adapted from the multiple-back-stack pattern

THIRD_PARTY_NOTICES.md

@@ -6,7 +6,7 @@ LiquidKit vendors Android Liquid Glass renderer and component source from:
 
 https://github.com/Kyant0/AndroidLiquidGlass
 
-Original author: Kyant
+Original author: Kyant
 License: Apache License 2.0
 
 The copied files live under:

.editorconfig

@@ -10,6 +10,13 @@ trim_trailing_whitespace = true
 [*.{kt,kts}]
 indent_size = 4
 continuation_indent_size = 4
+ktlint_code_style = ktlint_official
+max_line_length = 140
+ktlint_standard_max-line-length = disabled
+ktlint_standard_function-signature = disabled
+# Compose @Composable functions use PascalCase by convention.
+ktlint_function_naming_ignore_when_annotated_with = Composable
+ktlint_standard_function-naming = disabled
 
 [*.{yml,yaml,json,md,xml}]
 indent_size = 2

.github/workflows/ci.yml

@@ -1,13 +1,35 @@
 name: CI
 
 on:
+ push:
+ branches: [main]
+ pull_request:
  workflow_dispatch:
 
 concurrency:
  group: ci-${{ github.ref }}
  cancel-in-progress: true
 
 jobs:
+ quality:
+ name: Quality gates
+ runs-on: macos-latest
+ steps:
+ - name: Check out code
+ uses: actions/checkout@v4
+
+ - name: Set up JDK
+ uses: actions/setup-java@v4
+ with:
+ distribution: zulu
+ java-version: 17
+
+ - name: Set up Gradle
+ uses: gradle/actions/setup-gradle@v4
+
+ - name: Spotless + Detekt + Kover
+ run: ./gradlew spotlessCheck detekt koverXmlReport koverVerify --stacktrace
+
  build:
  name: Build KMP targets
  runs-on: macos-latest
@@ -32,3 +54,6 @@ jobs:
 
  - name: Compile iOS sample
  run: ./gradlew :sampleApp:compileKotlinIosSimulatorArm64 --stacktrace
+
+ - name: Validate Maven publication
+ run: ./gradlew publishToMavenLocal --stacktrace

.github/workflows/docs.yml

@@ -0,0 +1,50 @@
+name: Deploy docs
+
+on:
+ push:
+ branches: [main]
+ paths:
+ - 'website/**'
+ - '.github/workflows/docs.yml'
+ workflow_dispatch:
+
+permissions:
+ contents: read
+ pages: write
+ id-token: write
+
+concurrency:
+ group: pages
+ cancel-in-progress: true
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ defaults:
+ run:
+ working-directory: website
+ steps:
+ - uses: actions/checkout@v4
+ - uses: pnpm/action-setup@v4
+ with:
+ version: 10
+ - uses: actions/setup-node@v4
+ with:
+ node-version: 20
+ cache: pnpm
+ cache-dependency-path: website/pnpm-lock.yaml
+ - run: pnpm install --frozen-lockfile
+ - run: pnpm build
+ - uses: actions/upload-pages-artifact@v3
+ with:
+ path: website/out
+
+ deploy:
+ needs: build
+ runs-on: ubuntu-latest
+ environment:
+ name: github-pages
+ url: ${{ steps.deployment.outputs.page_url }}
+ steps:
+ - id: deployment
+ uses: actions/deploy-pages@v5

.github/workflows/publish.yml

@@ -2,12 +2,15 @@ name: Publish
 
 on:
  release:
- types: [released]
+ types: [published]
  workflow_dispatch:
 
+permissions:
+ contents: read
+
 jobs:
  publish:
- name: Validate release publication
+ name: Publish to Maven Central
  runs-on: macos-latest
  steps:
  - name: Check out code
@@ -22,5 +25,14 @@ jobs:
  - name: Set up Gradle
  uses: gradle/actions/setup-gradle@v4
 
- - name: Build library publications
- run: ./gradlew :liquidkit:publishAllPublicationsToLocalBuildRepository :liquidkit-navigation3:publishAllPublicationsToLocalBuildRepository --stacktrace
+ - name: Verify before publishing
+ run: ./gradlew spotlessCheck detekt koverXmlReport --stacktrace
+
+ - name: Publish and release to Maven Central
+ run: ./gradlew publishAndReleaseToMavenCentral --no-configuration-cache --stacktrace
+ env:
+ ORG_GRADLE_PROJECT_mavenCentralUsername: ${{ secrets.MAVEN_CENTRAL_USERNAME }}
+ ORG_GRADLE_PROJECT_mavenCentralPassword: ${{ secrets.MAVEN_CENTRAL_PASSWORD }}
+ ORG_GRADLE_PROJECT_signingInMemoryKeyId: ${{ secrets.SIGNING_KEY_ID }}
+ ORG_GRADLE_PROJECT_signingInMemoryKey: ${{ secrets.SIGNING_KEY }}
+ ORG_GRADLE_PROJECT_signingInMemoryKeyPassword: ${{ secrets.SIGNING_PASSWORD }}

.gitignore

@@ -4,3 +4,6 @@
 /*/build/
 iosApp/DerivedData/
 local.properties
+
+.idea/
+xcuserdata/

README.md

@@ -1,27 +1,75 @@
-# LiquidGlass
+# LiquidKit
 
-LiquidGlass is a Kotlin Multiplatform component kit for Liquid Glass-style UI.
+LiquidKit is a Kotlin Multiplatform component kit for Liquid Glass-style UI.
 
-Android renders with the vendored AndroidLiquidGlass engine. iOS renders with
-native UIKit controls through Compose interop.
+One shared Compose Multiplatform API; the rendering diverges per platform:
 
-> Maven/module coordinates still use `liquidkit` until a deliberate breaking
-> rename is made.
+- **Android** renders the glass look in-Compose via an internal backdrop-capture
+ and refraction (Liquid Glass) shader engine.
+- **iOS** wraps **genuine native UIKit controls** (`UISwitch`, `UIButton` glass
+ configuration, `UIMenu`, `UIPickerView`, `UITextField`, `UISearchTextField`,
+ `UIStepper`, `UINavigationBar`, `UIVisualEffectView`) so components get the
+ authentic system Liquid Glass on iOS 26, with a `UIBlurEffect` `systemMaterial`
+ fallback on earlier versions.
+
+See [Architecture](#architecture) for details.
+
+## Install
+
+LiquidKit is published to Maven Central as `io.github.androidpoet`.
 
 ```kotlin
-io.github.androidpoet.liquidkit
-io.github.androidpoet.liquidkit.navigation3 // optional
+// build.gradle.kts (Kotlin Multiplatform)
+kotlin {
+ sourceSets {
+ commonMain.dependencies {
+ implementation("io.github.androidpoet:liquidkit:0.1.0")
+ // Optional Navigation 3 tab-stack helpers:
+ implementation("io.github.androidpoet:liquidkit-navigation3:0.1.0")
+ }
+ }
+}
 ```
 
+With a version catalog (`gradle/libs.versions.toml`):
+
+```toml
+[libraries]
+liquidkit = { module = "io.github.androidpoet:liquidkit", version = "0.1.0" }
+liquidkit-navigation3 = { module = "io.github.androidpoet:liquidkit-navigation3", version = "0.1.0" }
+```
+
+On iOS the library builds a static Kotlin/Native framework named `LiquidKit`
+(and `LiquidKitNavigation3` for the optional module); consume it the same way as
+any Compose Multiplatform framework embedded by your iOS app.
+
 ## Components
 
-- `LiquidToggle`
-- `LiquidSlider`
-- `LiquidSegmentedControl`
-- `LiquidBottomNavigation`
-- `LiquidTabScaffold`
+LiquidKit ships an iOS-parity component set:
+
+- `LiquidButton` (variants via `LiquidButtonVariant`) and `LiquidFab`
+- `LiquidSurface` and `LiquidGlassContainer`
+- `LiquidDropdownMenu` (`LiquidMenuItem`) and `LiquidPicker` (`LiquidPickerOption`)
+- `LiquidTextField` and `LiquidSearchField`
+- `LiquidStepper` and `LiquidMediaControl`
+- `LiquidToolbar` and `LiquidSheet`
+- `LiquidToggle`, `LiquidSlider`, `LiquidSegmentedControl`
+- `LiquidBottomNavigation` and `LiquidTabScaffold`
 - `LiquidNav3TabScaffold` from the optional Navigation 3 module
 
+## Architecture
+
+LiquidKit is a single cross-platform Compose API backed by `expect`/`actual`
+platform implementations:
+
+- **Android shader** — components render their Liquid Glass appearance with an
+ internal backdrop capture + refraction shader engine, entirely in Compose.
+- **iOS native** — components wrap real UIKit controls through Compose interop,
+ so they inherit the system's authentic Liquid Glass on iOS 26 (and degrade
+ gracefully to a `UIBlurEffect` `systemMaterial` on earlier iOS).
+
+You write one API; each platform draws it the right way.
+
 ## Controls
 
 ```kotlin
@@ -62,7 +110,7 @@ LiquidBottomNavigation(
 )
 ```
 
-Use `LiquidTabScaffold` when LiquidGlass should hold the selected tab:
+Use `LiquidTabScaffold` when LiquidKit should hold the selected tab:
 
 ```kotlin
 LiquidTabScaffold(items = items) { selectedTab ->
@@ -74,10 +122,21 @@ LiquidTabScaffold(items = items) { selectedTab ->
 }
 ```
 
+Hide or replace only the bottom bar when another shell owns it:
+
+```kotlin
+LiquidTabScaffold(
+ items = items,
+ bottomNavigation = { _, _ -> },
+) { selectedTab ->
+ TabContent(selectedTab)
+}
+```
+
 ## Navigation 3
 
 Use `liquidkit-navigation3` only for Compose-owned bottom-navigation tab stacks.
-LiquidGlass handles the multiple back stacks; your app still owns `NavDisplay`.
+LiquidKit handles the multiple back stacks; your app still owns `NavDisplay`.
 
 ```kotlin
 val state = rememberLiquidNav3State(
@@ -116,7 +175,8 @@ LiquidNav3TabScaffold(
 ```
 
 For native iOS 26 Liquid Glass tabs, keep `TabView` in SwiftUI and host Compose
-screens inside each tab.
+screens inside each tab. If you reuse a Compose tab scaffold there, pass an empty
+`bottomNavigation` slot so SwiftUI is the only tab bar.
 
 ## Build
 
@@ -138,7 +198,7 @@ iosApp/LiquidKitSample.xcodeproj
 
 ## Credits
 
-LiquidGlass's Android renderer includes source from
+LiquidKit's Android renderer includes source from
 [Kyant0/AndroidLiquidGlass](https://github.com/Kyant0/AndroidLiquidGlass).
 
 The optional Navigation 3 helper is adapted from the multiple-back-stack pattern

THIRD_PARTY_NOTICES.md

@@ -6,7 +6,7 @@ LiquidKit vendors Android Liquid Glass renderer and component source from:
 
 https://github.com/Kyant0/AndroidLiquidGlass
 
-Original author: Kyant
+Original author: Kyant
 License: Apache License 2.0
 
 The copied files live under:

.editorconfig

@@ -10,6 +10,13 @@ trim_trailing_whitespace = true
 [*.{kt,kts}]
 indent_size = 4
 continuation_indent_size = 4
+ktlint_code_style = ktlint_official
+max_line_length = 140
+ktlint_standard_max-line-length = disabled
+ktlint_standard_function-signature = disabled
+# Compose @Composable functions use PascalCase by convention.
+ktlint_function_naming_ignore_when_annotated_with = Composable
+ktlint_standard_function-naming = disabled
 
 [*.{yml,yaml,json,md,xml}]
 indent_size = 2

.github/workflows/ci.yml

@@ -1,13 +1,35 @@
 name: CI
 
 on:
+ push:
+ branches: [main]
+ pull_request:
  workflow_dispatch:
 
 concurrency:
  group: ci-${{ github.ref }}
  cancel-in-progress: true
 
 jobs:
+ quality:
+ name: Quality gates
+ runs-on: macos-latest
+ steps:
+ - name: Check out code
+ uses: actions/checkout@v4
+
+ - name: Set up JDK
+ uses: actions/setup-java@v4
+ with:
+ distribution: zulu
+ java-version: 17
+
+ - name: Set up Gradle
+ uses: gradle/actions/setup-gradle@v4
+
+ - name: Spotless + Detekt + Kover
+ run: ./gradlew spotlessCheck detekt koverXmlReport koverVerify --stacktrace
+
  build:
  name: Build KMP targets
  runs-on: macos-latest
@@ -32,3 +54,6 @@ jobs:
 
  - name: Compile iOS sample
  run: ./gradlew :sampleApp:compileKotlinIosSimulatorArm64 --stacktrace
+
+ - name: Validate Maven publication
+ run: ./gradlew publishToMavenLocal --stacktrace

.github/workflows/docs.yml

@@ -0,0 +1,50 @@
+name: Deploy docs
+
+on:
+ push:
+ branches: [main]
+ paths:
+ - 'website/**'
+ - '.github/workflows/docs.yml'
+ workflow_dispatch:
+
+permissions:
+ contents: read
+ pages: write
+ id-token: write
+
+concurrency:
+ group: pages
+ cancel-in-progress: true
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ defaults:
+ run:
+ working-directory: website
+ steps:
+ - uses: actions/checkout@v4
+ - uses: pnpm/action-setup@v4
+ with:
+ version: 10
+ - uses: actions/setup-node@v4
+ with:
+ node-version: 20
+ cache: pnpm
+ cache-dependency-path: website/pnpm-lock.yaml
+ - run: pnpm install --frozen-lockfile
+ - run: pnpm build
+ - uses: actions/upload-pages-artifact@v3
+ with:
+ path: website/out
+
+ deploy:
+ needs: build
+ runs-on: ubuntu-latest
+ environment:
+ name: github-pages
+ url: ${{ steps.deployment.outputs.page_url }}
+ steps:
+ - id: deployment
+ uses: actions/deploy-pages@v5

.github/workflows/publish.yml

@@ -2,12 +2,15 @@ name: Publish
 
 on:
  release:
- types: [released]
+ types: [published]
  workflow_dispatch:
 
+permissions:
+ contents: read
+
 jobs:
  publish:
- name: Validate release publication
+ name: Publish to Maven Central
  runs-on: macos-latest
  steps:
  - name: Check out code
@@ -22,5 +25,14 @@ jobs:
  - name: Set up Gradle
  uses: gradle/actions/setup-gradle@v4
 
- - name: Build library publications
- run: ./gradlew :liquidkit:publishAllPublicationsToLocalBuildRepository :liquidkit-navigation3:publishAllPublicationsToLocalBuildRepository --stacktrace
+ - name: Verify before publishing
+ run: ./gradlew spotlessCheck detekt koverXmlReport --stacktrace
+
+ - name: Publish and release to Maven Central
+ run: ./gradlew publishAndReleaseToMavenCentral --no-configuration-cache --stacktrace
+ env:
+ ORG_GRADLE_PROJECT_mavenCentralUsername: ${{ secrets.MAVEN_CENTRAL_USERNAME }}
+ ORG_GRADLE_PROJECT_mavenCentralPassword: ${{ secrets.MAVEN_CENTRAL_PASSWORD }}
+ ORG_GRADLE_PROJECT_signingInMemoryKeyId: ${{ secrets.SIGNING_KEY_ID }}
+ ORG_GRADLE_PROJECT_signingInMemoryKey: ${{ secrets.SIGNING_KEY }}
+ ORG_GRADLE_PROJECT_signingInMemoryKeyPassword: ${{ secrets.SIGNING_PASSWORD }}

.gitignore

@@ -4,3 +4,6 @@
 /*/build/
 iosApp/DerivedData/
 local.properties
+
+.idea/
+xcuserdata/

README.md

@@ -1,27 +1,75 @@
-# LiquidGlass
+# LiquidKit
 
-LiquidGlass is a Kotlin Multiplatform component kit for Liquid Glass-style UI.
+LiquidKit is a Kotlin Multiplatform component kit for Liquid Glass-style UI.
 
-Android renders with the vendored AndroidLiquidGlass engine. iOS renders with
-native UIKit controls through Compose interop.
+One shared Compose Multiplatform API; the rendering diverges per platform:
 
-> Maven/module coordinates still use `liquidkit` until a deliberate breaking
-> rename is made.
+- **Android** renders the glass look in-Compose via an internal backdrop-capture
+ and refraction (Liquid Glass) shader engine.
+- **iOS** wraps **genuine native UIKit controls** (`UISwitch`, `UIButton` glass
+ configuration, `UIMenu`, `UIPickerView`, `UITextField`, `UISearchTextField`,
+ `UIStepper`, `UINavigationBar`, `UIVisualEffectView`) so components get the
+ authentic system Liquid Glass on iOS 26, with a `UIBlurEffect` `systemMaterial`
+ fallback on earlier versions.
+
+See [Architecture](#architecture) for details.
+
+## Install
+
+LiquidKit is published to Maven Central as `io.github.androidpoet`.
 
 ```kotlin
-io.github.androidpoet.liquidkit
-io.github.androidpoet.liquidkit.navigation3 // optional
+// build.gradle.kts (Kotlin Multiplatform)
+kotlin {
+ sourceSets {
+ commonMain.dependencies {
+ implementation("io.github.androidpoet:liquidkit:0.1.0")
+ // Optional Navigation 3 tab-stack helpers:
+ implementation("io.github.androidpoet:liquidkit-navigation3:0.1.0")
+ }
+ }
+}
 ```
 
+With a version catalog (`gradle/libs.versions.toml`):
+
+```toml
+[libraries]
+liquidkit = { module = "io.github.androidpoet:liquidkit", version = "0.1.0" }
+liquidkit-navigation3 = { module = "io.github.androidpoet:liquidkit-navigation3", version = "0.1.0" }
+```
+
+On iOS the library builds a static Kotlin/Native framework named `LiquidKit`
+(and `LiquidKitNavigation3` for the optional module); consume it the same way as
+any Compose Multiplatform framework embedded by your iOS app.
+
 ## Components
 
-- `LiquidToggle`
-- `LiquidSlider`
-- `LiquidSegmentedControl`
-- `LiquidBottomNavigation`
-- `LiquidTabScaffold`
+LiquidKit ships an iOS-parity component set:
+
+- `LiquidButton` (variants via `LiquidButtonVariant`) and `LiquidFab`
+- `LiquidSurface` and `LiquidGlassContainer`
+- `LiquidDropdownMenu` (`LiquidMenuItem`) and `LiquidPicker` (`LiquidPickerOption`)
+- `LiquidTextField` and `LiquidSearchField`
+- `LiquidStepper` and `LiquidMediaControl`
+- `LiquidToolbar` and `LiquidSheet`
+- `LiquidToggle`, `LiquidSlider`, `LiquidSegmentedControl`
+- `LiquidBottomNavigation` and `LiquidTabScaffold`
 - `LiquidNav3TabScaffold` from the optional Navigation 3 module
 
+## Architecture
+
+LiquidKit is a single cross-platform Compose API backed by `expect`/`actual`
+platform implementations:
+
+- **Android shader** — components render their Liquid Glass appearance with an
+ internal backdrop capture + refraction shader engine, entirely in Compose.
+- **iOS native** — components wrap real UIKit controls through Compose interop,
+ so they inherit the system's authentic Liquid Glass on iOS 26 (and degrade
+ gracefully to a `UIBlurEffect` `systemMaterial` on earlier iOS).
+
+You write one API; each platform draws it the right way.
+
 ## Controls
 
 ```kotlin
@@ -62,7 +110,7 @@ LiquidBottomNavigation(
 )
 ```
 
-Use `LiquidTabScaffold` when LiquidGlass should hold the selected tab:
+Use `LiquidTabScaffold` when LiquidKit should hold the selected tab:
 
 ```kotlin
 LiquidTabScaffold(items = items) { selectedTab ->
@@ -74,10 +122,21 @@ LiquidTabScaffold(items = items) { selectedTab ->
 }
 ```
 
+Hide or replace only the bottom bar when another shell owns it:
+
+```kotlin
+LiquidTabScaffold(
+ items = items,
+ bottomNavigation = { _, _ -> },
+) { selectedTab ->
+ TabContent(selectedTab)
+}
+```
+
 ## Navigation 3
 
 Use `liquidkit-navigation3` only for Compose-owned bottom-navigation tab stacks.
-LiquidGlass handles the multiple back stacks; your app still owns `NavDisplay`.
+LiquidKit handles the multiple back stacks; your app still owns `NavDisplay`.
 
 ```kotlin
 val state = rememberLiquidNav3State(
@@ -116,7 +175,8 @@ LiquidNav3TabScaffold(
 ```
 
 For native iOS 26 Liquid Glass tabs, keep `TabView` in SwiftUI and host Compose
-screens inside each tab.
+screens inside each tab. If you reuse a Compose tab scaffold there, pass an empty
+`bottomNavigation` slot so SwiftUI is the only tab bar.
 
 ## Build
 
@@ -138,7 +198,7 @@ iosApp/LiquidKitSample.xcodeproj
 
 ## Credits
 
-LiquidGlass's Android renderer includes source from
+LiquidKit's Android renderer includes source from
 [Kyant0/AndroidLiquidGlass](https://github.com/Kyant0/AndroidLiquidGlass).
 
 The optional Navigation 3 helper is adapted from the multiple-back-stack pattern

THIRD_PARTY_NOTICES.md

@@ -6,7 +6,7 @@ LiquidKit vendors Android Liquid Glass renderer and component source from:
 
 https://github.com/Kyant0/AndroidLiquidGlass
 
-Original author: Kyant
+Original author: Kyant
 License: Apache License 2.0
 
 The copied files live under:

.editorconfig

@@ -10,6 +10,13 @@ trim_trailing_whitespace = true
 [*.{kt,kts}]
 indent_size = 4
 continuation_indent_size = 4
+ktlint_code_style = ktlint_official
+max_line_length = 140
+ktlint_standard_max-line-length = disabled
+ktlint_standard_function-signature = disabled
+# Compose @Composable functions use PascalCase by convention.
+ktlint_function_naming_ignore_when_annotated_with = Composable
+ktlint_standard_function-naming = disabled
 
 [*.{yml,yaml,json,md,xml}]
 indent_size = 2

.github/workflows/ci.yml

@@ -1,13 +1,35 @@
 name: CI
 
 on:
+ push:
+ branches: [main]
+ pull_request:
  workflow_dispatch:
 
 concurrency:
  group: ci-${{ github.ref }}
  cancel-in-progress: true
 
 jobs:
+ quality:
+ name: Quality gates
+ runs-on: macos-latest
+ steps:
+ - name: Check out code
+ uses: actions/checkout@v4
+
+ - name: Set up JDK
+ uses: actions/setup-java@v4
+ with:
+ distribution: zulu
+ java-version: 17
+
+ - name: Set up Gradle
+ uses: gradle/actions/setup-gradle@v4
+
+ - name: Spotless + Detekt + Kover
+ run: ./gradlew spotlessCheck detekt koverXmlReport koverVerify --stacktrace
+
  build:
  name: Build KMP targets
  runs-on: macos-latest
@@ -32,3 +54,6 @@ jobs:
 
  - name: Compile iOS sample
  run: ./gradlew :sampleApp:compileKotlinIosSimulatorArm64 --stacktrace
+
+ - name: Validate Maven publication
+ run: ./gradlew publishToMavenLocal --stacktrace

.github/workflows/docs.yml

@@ -0,0 +1,50 @@
+name: Deploy docs
+
+on:
+ push:
+ branches: [main]
+ paths:
+ - 'website/**'
+ - '.github/workflows/docs.yml'
+ workflow_dispatch:
+
+permissions:
+ contents: read
+ pages: write
+ id-token: write
+
+concurrency:
+ group: pages
+ cancel-in-progress: true
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ defaults:
+ run:
+ working-directory: website
+ steps:
+ - uses: actions/checkout@v4
+ - uses: pnpm/action-setup@v4
+ with:
+ version: 10
+ - uses: actions/setup-node@v4
+ with:
+ node-version: 20
+ cache: pnpm
+ cache-dependency-path: website/pnpm-lock.yaml
+ - run: pnpm install --frozen-lockfile
+ - run: pnpm build
+ - uses: actions/upload-pages-artifact@v3
+ with:
+ path: website/out
+
+ deploy:
+ needs: build
+ runs-on: ubuntu-latest
+ environment:
+ name: github-pages
+ url: ${{ steps.deployment.outputs.page_url }}
+ steps:
+ - id: deployment
+ uses: actions/deploy-pages@v5

.github/workflows/publish.yml

@@ -2,12 +2,15 @@ name: Publish
 
 on:
  release:
- types: [released]
+ types: [published]
  workflow_dispatch:
 
+permissions:
+ contents: read
+
 jobs:
  publish:
- name: Validate release publication
+ name: Publish to Maven Central
  runs-on: macos-latest
  steps:
  - name: Check out code
@@ -22,5 +25,14 @@ jobs:
  - name: Set up Gradle
  uses: gradle/actions/setup-gradle@v4
 
- - name: Build library publications
- run: ./gradlew :liquidkit:publishAllPublicationsToLocalBuildRepository :liquidkit-navigation3:publishAllPublicationsToLocalBuildRepository --stacktrace
+ - name: Verify before publishing
+ run: ./gradlew spotlessCheck detekt koverXmlReport --stacktrace
+
+ - name: Publish and release to Maven Central
+ run: ./gradlew publishAndReleaseToMavenCentral --no-configuration-cache --stacktrace
+ env:
+ ORG_GRADLE_PROJECT_mavenCentralUsername: ${{ secrets.MAVEN_CENTRAL_USERNAME }}
+ ORG_GRADLE_PROJECT_mavenCentralPassword: ${{ secrets.MAVEN_CENTRAL_PASSWORD }}
+ ORG_GRADLE_PROJECT_signingInMemoryKeyId: ${{ secrets.SIGNING_KEY_ID }}
+ ORG_GRADLE_PROJECT_signingInMemoryKey: ${{ secrets.SIGNING_KEY }}
+ ORG_GRADLE_PROJECT_signingInMemoryKeyPassword: ${{ secrets.SIGNING_PASSWORD }}

.gitignore

@@ -4,3 +4,6 @@
 /*/build/
 iosApp/DerivedData/
 local.properties
+
+.idea/
+xcuserdata/

README.md

@@ -1,27 +1,75 @@
-# LiquidGlass
+# LiquidKit
 
-LiquidGlass is a Kotlin Multiplatform component kit for Liquid Glass-style UI.
+LiquidKit is a Kotlin Multiplatform component kit for Liquid Glass-style UI.
 
-Android renders with the vendored AndroidLiquidGlass engine. iOS renders with
-native UIKit controls through Compose interop.
+One shared Compose Multiplatform API; the rendering diverges per platform:
 
-> Maven/module coordinates still use `liquidkit` until a deliberate breaking
-> rename is made.
+- **Android** renders the glass look in-Compose via an internal backdrop-capture
+ and refraction (Liquid Glass) shader engine.
+- **iOS** wraps **genuine native UIKit controls** (`UISwitch`, `UIButton` glass
+ configuration, `UIMenu`, `UIPickerView`, `UITextField`, `UISearchTextField`,
+ `UIStepper`, `UINavigationBar`, `UIVisualEffectView`) so components get the
+ authentic system Liquid Glass on iOS 26, with a `UIBlurEffect` `systemMaterial`
+ fallback on earlier versions.
+
+See [Architecture](#architecture) for details.
+
+## Install
+
+LiquidKit is published to Maven Central as `io.github.androidpoet`.
 
 ```kotlin
-io.github.androidpoet.liquidkit
-io.github.androidpoet.liquidkit.navigation3 // optional
+// build.gradle.kts (Kotlin Multiplatform)
+kotlin {
+ sourceSets {
+ commonMain.dependencies {
+ implementation("io.github.androidpoet:liquidkit:0.1.0")
+ // Optional Navigation 3 tab-stack helpers:
+ implementation("io.github.androidpoet:liquidkit-navigation3:0.1.0")
+ }
+ }
+}
 ```
 
+With a version catalog (`gradle/libs.versions.toml`):
+
+```toml
+[libraries]
+liquidkit = { module = "io.github.androidpoet:liquidkit", version = "0.1.0" }
+liquidkit-navigation3 = { module = "io.github.androidpoet:liquidkit-navigation3", version = "0.1.0" }
+```
+
+On iOS the library builds a static Kotlin/Native framework named `LiquidKit`
+(and `LiquidKitNavigation3` for the optional module); consume it the same way as
+any Compose Multiplatform framework embedded by your iOS app.
+
 ## Components
 
-- `LiquidToggle`
-- `LiquidSlider`
-- `LiquidSegmentedControl`
-- `LiquidBottomNavigation`
-- `LiquidTabScaffold`
+LiquidKit ships an iOS-parity component set:
+
+- `LiquidButton` (variants via `LiquidButtonVariant`) and `LiquidFab`
+- `LiquidSurface` and `LiquidGlassContainer`
+- `LiquidDropdownMenu` (`LiquidMenuItem`) and `LiquidPicker` (`LiquidPickerOption`)
+- `LiquidTextField` and `LiquidSearchField`
+- `LiquidStepper` and `LiquidMediaControl`
+- `LiquidToolbar` and `LiquidSheet`
+- `LiquidToggle`, `LiquidSlider`, `LiquidSegmentedControl`
+- `LiquidBottomNavigation` and `LiquidTabScaffold`
 - `LiquidNav3TabScaffold` from the optional Navigation 3 module
 
+## Architecture
+
+LiquidKit is a single cross-platform Compose API backed by `expect`/`actual`
+platform implementations:
+
+- **Android shader** — components render their Liquid Glass appearance with an
+ internal backdrop capture + refraction shader engine, entirely in Compose.
+- **iOS native** — components wrap real UIKit controls through Compose interop,
+ so they inherit the system's authentic Liquid Glass on iOS 26 (and degrade
+ gracefully to a `UIBlurEffect` `systemMaterial` on earlier iOS).
+
+You write one API; each platform draws it the right way.
+
 ## Controls
 
 ```kotlin
@@ -62,7 +110,7 @@ LiquidBottomNavigation(
 )
 ```
 
-Use `LiquidTabScaffold` when LiquidGlass should hold the selected tab:
+Use `LiquidTabScaffold` when LiquidKit should hold the selected tab:
 
 ```kotlin
 LiquidTabScaffold(items = items) { selectedTab ->
@@ -74,10 +122,21 @@ LiquidTabScaffold(items = items) { selectedTab ->
 }
 ```
 
+Hide or replace only the bottom bar when another shell owns it:
+
+```kotlin
+LiquidTabScaffold(
+ items = items,
+ bottomNavigation = { _, _ -> },
+) { selectedTab ->
+ TabContent(selectedTab)
+}
+```
+
 ## Navigation 3
 
 Use `liquidkit-navigation3` only for Compose-owned bottom-navigation tab stacks.
-LiquidGlass handles the multiple back stacks; your app still owns `NavDisplay`.
+LiquidKit handles the multiple back stacks; your app still owns `NavDisplay`.
 
 ```kotlin
 val state = rememberLiquidNav3State(
@@ -116,7 +175,8 @@ LiquidNav3TabScaffold(
 ```
 
 For native iOS 26 Liquid Glass tabs, keep `TabView` in SwiftUI and host Compose
-screens inside each tab.
+screens inside each tab. If you reuse a Compose tab scaffold there, pass an empty
+`bottomNavigation` slot so SwiftUI is the only tab bar.
 
 ## Build
 
@@ -138,7 +198,7 @@ iosApp/LiquidKitSample.xcodeproj
 
 ## Credits
 
-LiquidGlass's Android renderer includes source from
+LiquidKit's Android renderer includes source from
 [Kyant0/AndroidLiquidGlass](https://github.com/Kyant0/AndroidLiquidGlass).
 
 The optional Navigation 3 helper is adapted from the multiple-back-stack pattern

THIRD_PARTY_NOTICES.md

@@ -6,7 +6,7 @@ LiquidKit vendors Android Liquid Glass renderer and component source from:
 
 https://github.com/Kyant0/AndroidLiquidGlass
 
-Original author: Kyant
+Original author: Kyant
 License: Apache License 2.0
 
 The copied files live under:

.editorconfig

@@ -10,6 +10,13 @@ trim_trailing_whitespace = true
 [*.{kt,kts}]
 indent_size = 4
 continuation_indent_size = 4
+ktlint_code_style = ktlint_official
+max_line_length = 140
+ktlint_standard_max-line-length = disabled
+ktlint_standard_function-signature = disabled
+# Compose @Composable functions use PascalCase by convention.
+ktlint_function_naming_ignore_when_annotated_with = Composable
+ktlint_standard_function-naming = disabled
 
 [*.{yml,yaml,json,md,xml}]
 indent_size = 2

.github/workflows/ci.yml

@@ -1,13 +1,35 @@
 name: CI
 
 on:
+ push:
+ branches: [main]
+ pull_request:
  workflow_dispatch:
 
 concurrency:
  group: ci-${{ github.ref }}
  cancel-in-progress: true
 
 jobs:
+ quality:
+ name: Quality gates
+ runs-on: macos-latest
+ steps:
+ - name: Check out code
+ uses: actions/checkout@v4
+
+ - name: Set up JDK
+ uses: actions/setup-java@v4
+ with:
+ distribution: zulu
+ java-version: 17
+
+ - name: Set up Gradle
+ uses: gradle/actions/setup-gradle@v4
+
+ - name: Spotless + Detekt + Kover
+ run: ./gradlew spotlessCheck detekt koverXmlReport koverVerify --stacktrace
+
  build:
  name: Build KMP targets
  runs-on: macos-latest
@@ -32,3 +54,6 @@ jobs:
 
  - name: Compile iOS sample
  run: ./gradlew :sampleApp:compileKotlinIosSimulatorArm64 --stacktrace
+
+ - name: Validate Maven publication
+ run: ./gradlew publishToMavenLocal --stacktrace

.github/workflows/docs.yml

@@ -0,0 +1,50 @@
+name: Deploy docs
+
+on:
+ push:
+ branches: [main]
+ paths:
+ - 'website/**'
+ - '.github/workflows/docs.yml'
+ workflow_dispatch:
+
+permissions:
+ contents: read
+ pages: write
+ id-token: write
+
+concurrency:
+ group: pages
+ cancel-in-progress: true
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ defaults:
+ run:
+ working-directory: website
+ steps:
+ - uses: actions/checkout@v4
+ - uses: pnpm/action-setup@v4
+ with:
+ version: 10
+ - uses: actions/setup-node@v4
+ with:
+ node-version: 20
+ cache: pnpm
+ cache-dependency-path: website/pnpm-lock.yaml
+ - run: pnpm install --frozen-lockfile
+ - run: pnpm build
+ - uses: actions/upload-pages-artifact@v3
+ with:
+ path: website/out
+
+ deploy:
+ needs: build
+ runs-on: ubuntu-latest
+ environment:
+ name: github-pages
+ url: ${{ steps.deployment.outputs.page_url }}
+ steps:
+ - id: deployment
+ uses: actions/deploy-pages@v5

.github/workflows/publish.yml

@@ -2,12 +2,15 @@ name: Publish
 
 on:
  release:
- types: [released]
+ types: [published]
  workflow_dispatch:
 
+permissions:
+ contents: read
+
 jobs:
  publish:
- name: Validate release publication
+ name: Publish to Maven Central
  runs-on: macos-latest
  steps:
  - name: Check out code
@@ -22,5 +25,14 @@ jobs:
  - name: Set up Gradle
  uses: gradle/actions/setup-gradle@v4
 
- - name: Build library publications
- run: ./gradlew :liquidkit:publishAllPublicationsToLocalBuildRepository :liquidkit-navigation3:publishAllPublicationsToLocalBuildRepository --stacktrace
+ - name: Verify before publishing
+ run: ./gradlew spotlessCheck detekt koverXmlReport --stacktrace
+
+ - name: Publish and release to Maven Central
+ run: ./gradlew publishAndReleaseToMavenCentral --no-configuration-cache --stacktrace
+ env:
+ ORG_GRADLE_PROJECT_mavenCentralUsername: ${{ secrets.MAVEN_CENTRAL_USERNAME }}
+ ORG_GRADLE_PROJECT_mavenCentralPassword: ${{ secrets.MAVEN_CENTRAL_PASSWORD }}
+ ORG_GRADLE_PROJECT_signingInMemoryKeyId: ${{ secrets.SIGNING_KEY_ID }}
+ ORG_GRADLE_PROJECT_signingInMemoryKey: ${{ secrets.SIGNING_KEY }}
+ ORG_GRADLE_PROJECT_signingInMemoryKeyPassword: ${{ secrets.SIGNING_PASSWORD }}

.gitignore

@@ -4,3 +4,6 @@
 /*/build/
 iosApp/DerivedData/
 local.properties
+
+.idea/
+xcuserdata/

README.md

@@ -1,27 +1,75 @@
-# LiquidGlass
+# LiquidKit
 
-LiquidGlass is a Kotlin Multiplatform component kit for Liquid Glass-style UI.
+LiquidKit is a Kotlin Multiplatform component kit for Liquid Glass-style UI.
 
-Android renders with the vendored AndroidLiquidGlass engine. iOS renders with
-native UIKit controls through Compose interop.
+One shared Compose Multiplatform API; the rendering diverges per platform:
 
-> Maven/module coordinates still use `liquidkit` until a deliberate breaking
-> rename is made.
+- **Android** renders the glass look in-Compose via an internal backdrop-capture
+ and refraction (Liquid Glass) shader engine.
+- **iOS** wraps **genuine native UIKit controls** (`UISwitch`, `UIButton` glass
+ configuration, `UIMenu`, `UIPickerView`, `UITextField`, `UISearchTextField`,
+ `UIStepper`, `UINavigationBar`, `UIVisualEffectView`) so components get the
+ authentic system Liquid Glass on iOS 26, with a `UIBlurEffect` `systemMaterial`
+ fallback on earlier versions.
+
+See [Architecture](#architecture) for details.
+
+## Install
+
+LiquidKit is published to Maven Central as `io.github.androidpoet`.
 
 ```kotlin
-io.github.androidpoet.liquidkit
-io.github.androidpoet.liquidkit.navigation3 // optional
+// build.gradle.kts (Kotlin Multiplatform)
+kotlin {
+ sourceSets {
+ commonMain.dependencies {
+ implementation("io.github.androidpoet:liquidkit:0.1.0")
+ // Optional Navigation 3 tab-stack helpers:
+ implementation("io.github.androidpoet:liquidkit-navigation3:0.1.0")
+ }
+ }
+}
 ```
 
+With a version catalog (`gradle/libs.versions.toml`):
+
+```toml
+[libraries]
+liquidkit = { module = "io.github.androidpoet:liquidkit", version = "0.1.0" }
+liquidkit-navigation3 = { module = "io.github.androidpoet:liquidkit-navigation3", version = "0.1.0" }
+```
+
+On iOS the library builds a static Kotlin/Native framework named `LiquidKit`
+(and `LiquidKitNavigation3` for the optional module); consume it the same way as
+any Compose Multiplatform framework embedded by your iOS app.
+
 ## Components
 
-- `LiquidToggle`
-- `LiquidSlider`
-- `LiquidSegmentedControl`
-- `LiquidBottomNavigation`
-- `LiquidTabScaffold`
+LiquidKit ships an iOS-parity component set:
+
+- `LiquidButton` (variants via `LiquidButtonVariant`) and `LiquidFab`
+- `LiquidSurface` and `LiquidGlassContainer`
+- `LiquidDropdownMenu` (`LiquidMenuItem`) and `LiquidPicker` (`LiquidPickerOption`)
+- `LiquidTextField` and `LiquidSearchField`
+- `LiquidStepper` and `LiquidMediaControl`
+- `LiquidToolbar` and `LiquidSheet`
+- `LiquidToggle`, `LiquidSlider`, `LiquidSegmentedControl`
+- `LiquidBottomNavigation` and `LiquidTabScaffold`
 - `LiquidNav3TabScaffold` from the optional Navigation 3 module
 
+## Architecture
+
+LiquidKit is a single cross-platform Compose API backed by `expect`/`actual`
+platform implementations:
+
+- **Android shader** — components render their Liquid Glass appearance with an
+ internal backdrop capture + refraction shader engine, entirely in Compose.
+- **iOS native** — components wrap real UIKit controls through Compose interop,
+ so they inherit the system's authentic Liquid Glass on iOS 26 (and degrade
+ gracefully to a `UIBlurEffect` `systemMaterial` on earlier iOS).
+
+You write one API; each platform draws it the right way.
+
 ## Controls
 
 ```kotlin
@@ -62,7 +110,7 @@ LiquidBottomNavigation(
 )
 ```
 
-Use `LiquidTabScaffold` when LiquidGlass should hold the selected tab:
+Use `LiquidTabScaffold` when LiquidKit should hold the selected tab:
 
 ```kotlin
 LiquidTabScaffold(items = items) { selectedTab ->
@@ -74,10 +122,21 @@ LiquidTabScaffold(items = items) { selectedTab ->
 }
 ```
 
+Hide or replace only the bottom bar when another shell owns it:
+
+```kotlin
+LiquidTabScaffold(
+ items = items,
+ bottomNavigation = { _, _ -> },
+) { selectedTab ->
+ TabContent(selectedTab)
+}
+```
+
 ## Navigation 3
 
 Use `liquidkit-navigation3` only for Compose-owned bottom-navigation tab stacks.
-LiquidGlass handles the multiple back stacks; your app still owns `NavDisplay`.
+LiquidKit handles the multiple back stacks; your app still owns `NavDisplay`.
 
 ```kotlin
 val state = rememberLiquidNav3State(
@@ -116,7 +175,8 @@ LiquidNav3TabScaffold(
 ```
 
 For native iOS 26 Liquid Glass tabs, keep `TabView` in SwiftUI and host Compose
-screens inside each tab.
+screens inside each tab. If you reuse a Compose tab scaffold there, pass an empty
+`bottomNavigation` slot so SwiftUI is the only tab bar.
 
 ## Build
 
@@ -138,7 +198,7 @@ iosApp/LiquidKitSample.xcodeproj
 
 ## Credits
 
-LiquidGlass's Android renderer includes source from
+LiquidKit's Android renderer includes source from
 [Kyant0/AndroidLiquidGlass](https://github.com/Kyant0/AndroidLiquidGlass).
 
 The optional Navigation 3 helper is adapted from the multiple-back-stack pattern

THIRD_PARTY_NOTICES.md

@@ -6,7 +6,7 @@ LiquidKit vendors Android Liquid Glass renderer and component source from:
 
 https://github.com/Kyant0/AndroidLiquidGlass
 
-Original author: Kyant
+Original author: Kyant
 License: Apache License 2.0
 
 The copied files live under:

.editorconfig

@@ -10,6 +10,13 @@ trim_trailing_whitespace = true
 [*.{kt,kts}]
 indent_size = 4
 continuation_indent_size = 4
+ktlint_code_style = ktlint_official
+max_line_length = 140
+ktlint_standard_max-line-length = disabled
+ktlint_standard_function-signature = disabled
+# Compose @Composable functions use PascalCase by convention.
+ktlint_function_naming_ignore_when_annotated_with = Composable
+ktlint_standard_function-naming = disabled
 
 [*.{yml,yaml,json,md,xml}]
 indent_size = 2

.github/workflows/ci.yml

@@ -1,13 +1,35 @@
 name: CI
 
 on:
+ push:
+ branches: [main]
+ pull_request:
  workflow_dispatch:
 
 concurrency:
  group: ci-${{ github.ref }}
  cancel-in-progress: true
 
 jobs:
+ quality:
+ name: Quality gates
+ runs-on: macos-latest
+ steps:
+ - name: Check out code
+ uses: actions/checkout@v4
+
+ - name: Set up JDK
+ uses: actions/setup-java@v4
+ with:
+ distribution: zulu
+ java-version: 17
+
+ - name: Set up Gradle
+ uses: gradle/actions/setup-gradle@v4
+
+ - name: Spotless + Detekt + Kover
+ run: ./gradlew spotlessCheck detekt koverXmlReport koverVerify --stacktrace
+
  build:
  name: Build KMP targets
  runs-on: macos-latest
@@ -32,3 +54,6 @@ jobs:
 
  - name: Compile iOS sample
  run: ./gradlew :sampleApp:compileKotlinIosSimulatorArm64 --stacktrace
+
+ - name: Validate Maven publication
+ run: ./gradlew publishToMavenLocal --stacktrace

.github/workflows/docs.yml

@@ -0,0 +1,50 @@
+name: Deploy docs
+
+on:
+ push:
+ branches: [main]
+ paths:
+ - 'website/**'
+ - '.github/workflows/docs.yml'
+ workflow_dispatch:
+
+permissions:
+ contents: read
+ pages: write
+ id-token: write
+
+concurrency:
+ group: pages
+ cancel-in-progress: true
+
+jobs:
+ build:
+ runs-on: ubuntu-latest
+ defaults:
+ run:
+ working-directory: website
+ steps:
+ - uses: actions/checkout@v4
+ - uses: pnpm/action-setup@v4
+ with:
+ version: 10
+ - uses: actions/setup-node@v4
+ with:
+ node-version: 20
+ cache: pnpm
+ cache-dependency-path: website/pnpm-lock.yaml
+ - run: pnpm install --frozen-lockfile
+ - run: pnpm build
+ - uses: actions/upload-pages-artifact@v3
+ with:
+ path: website/out
+
+ deploy:
+ needs: build
+ runs-on: ubuntu-latest
+ environment:
+ name: github-pages
+ url: ${{ steps.deployment.outputs.page_url }}
+ steps:
+ - id: deployment
+ uses: actions/deploy-pages@v5

.github/workflows/publish.yml

@@ -2,12 +2,15 @@ name: Publish
 
 on:
  release:
- types: [released]
+ types: [published]
  workflow_dispatch:
 
+permissions:
+ contents: read
+
 jobs:
  publish:
- name: Validate release publication
+ name: Publish to Maven Central
  runs-on: macos-latest
  steps:
  - name: Check out code
@@ -22,5 +25,14 @@ jobs:
  - name: Set up Gradle
  uses: gradle/actions/setup-gradle@v4
 
- - name: Build library publications
- run: ./gradlew :liquidkit:publishAllPublicationsToLocalBuildRepository :liquidkit-navigation3:publishAllPublicationsToLocalBuildRepository --stacktrace
+ - name: Verify before publishing
+ run: ./gradlew spotlessCheck detekt koverXmlReport --stacktrace
+
+ - name: Publish and release to Maven Central
+ run: ./gradlew publishAndReleaseToMavenCentral --no-configuration-cache --stacktrace
+ env:
+ ORG_GRADLE_PROJECT_mavenCentralUsername: ${{ secrets.MAVEN_CENTRAL_USERNAME }}
+ ORG_GRADLE_PROJECT_mavenCentralPassword: ${{ secrets.MAVEN_CENTRAL_PASSWORD }}
+ ORG_GRADLE_PROJECT_signingInMemoryKeyId: ${{ secrets.SIGNING_KEY_ID }}
+ ORG_GRADLE_PROJECT_signingInMemoryKey: ${{ secrets.SIGNING_KEY }}
+ ORG_GRADLE_PROJECT_signingInMemoryKeyPassword: ${{ secrets.SIGNING_PASSWORD }}

.gitignore

@@ -4,3 +4,6 @@
 /*/build/
 iosApp/DerivedData/
 local.properties
+
+.idea/
+xcuserdata/

README.md

@@ -1,27 +1,75 @@
-# LiquidGlass
+# LiquidKit
 
-LiquidGlass is a Kotlin Multiplatform component kit for Liquid Glass-style UI.
+LiquidKit is a Kotlin Multiplatform component kit for Liquid Glass-style UI.
 
-Android renders with the vendored AndroidLiquidGlass engine. iOS renders with
-native UIKit controls through Compose interop.
+One shared Compose Multiplatform API; the rendering diverges per platform:
 
-> Maven/module coordinates still use `liquidkit` until a deliberate breaking
-> rename is made.
+- **Android** renders the glass look in-Compose via an internal backdrop-capture
+ and refraction (Liquid Glass) shader engine.
+- **iOS** wraps **genuine native UIKit controls** (`UISwitch`, `UIButton` glass
+ configuration, `UIMenu`, `UIPickerView`, `UITextField`, `UISearchTextField`,
+ `UIStepper`, `UINavigationBar`, `UIVisualEffectView`) so components get the
+ authentic system Liquid Glass on iOS 26, with a `UIBlurEffect` `systemMaterial`
+ fallback on earlier versions.
+
+See [Architecture](#architecture) for details.
+
+## Install
+
+LiquidKit is published to Maven Central as `io.github.androidpoet`.
 
 ```kotlin
-io.github.androidpoet.liquidkit
-io.github.androidpoet.liquidkit.navigation3 // optional
+// build.gradle.kts (Kotlin Multiplatform)
+kotlin {
+ sourceSets {
+ commonMain.dependencies {
+ implementation("io.github.androidpoet:liquidkit:0.1.0")
+ // Optional Navigation 3 tab-stack helpers:
+ implementation("io.github.androidpoet:liquidkit-navigation3:0.1.0")
+ }
+ }
+}
 ```
 
+With a version catalog (`gradle/libs.versions.toml`):
+
+```toml
+[libraries]
+liquidkit = { module = "io.github.androidpoet:liquidkit", version = "0.1.0" }
+liquidkit-navigation3 = { module = "io.github.androidpoet:liquidkit-navigation3", version = "0.1.0" }
+```
+
+On iOS the library builds a static Kotlin/Native framework named `LiquidKit`
+(and `LiquidKitNavigation3` for the optional module); consume it the same way as
+any Compose Multiplatform framework embedded by your iOS app.
+
 ## Components
 
-- `LiquidToggle`
-- `LiquidSlider`
-- `LiquidSegmentedControl`
-- `LiquidBottomNavigation`
-- `LiquidTabScaffold`
+LiquidKit ships an iOS-parity component set:
+
+- `LiquidButton` (variants via `LiquidButtonVariant`) and `LiquidFab`
+- `LiquidSurface` and `LiquidGlassContainer`
+- `LiquidDropdownMenu` (`LiquidMenuItem`) and `LiquidPicker` (`LiquidPickerOption`)
+- `LiquidTextField` and `LiquidSearchField`
+- `LiquidStepper` and `LiquidMediaControl`
+- `LiquidToolbar` and `LiquidSheet`
+- `LiquidToggle`, `LiquidSlider`, `LiquidSegmentedControl`
+- `LiquidBottomNavigation` and `LiquidTabScaffold`
 - `LiquidNav3TabScaffold` from the optional Navigation 3 module
 
+## Architecture
+
+LiquidKit is a single cross-platform Compose API backed by `expect`/`actual`
+platform implementations:
+
+- **Android shader** — components render their Liquid Glass appearance with an
+ internal backdrop capture + refraction shader engine, entirely in Compose.
+- **iOS native** — components wrap real UIKit controls through Compose interop,
+ so they inherit the system's authentic Liquid Glass on iOS 26 (and degrade
+ gracefully to a `UIBlurEffect` `systemMaterial` on earlier iOS).
+
+You write one API; each platform draws it the right way.
+
 ## Controls
 
 ```kotlin
@@ -62,7 +110,7 @@ LiquidBottomNavigation(
 )
 ```
 
-Use `LiquidTabScaffold` when LiquidGlass should hold the selected tab:
+Use `LiquidTabScaffold` when LiquidKit should hold the selected tab:
 
 ```kotlin
 LiquidTabScaffold(items = items) { selectedTab ->
@@ -74,10 +122,21 @@ LiquidTabScaffold(items = items) { selectedTab ->
 }
 ```
 
+Hide or replace only the bottom bar when another shell owns it:
+
+```kotlin
+LiquidTabScaffold(
+ items = items,
+ bottomNavigation = { _, _ -> },
+) { selectedTab ->
+ TabContent(selectedTab)
+}
+```
+
 ## Navigation 3
 
 Use `liquidkit-navigation3` only for Compose-owned bottom-navigation tab stacks.
-LiquidGlass handles the multiple back stacks; your app still owns `NavDisplay`.
+LiquidKit handles the multiple back stacks; your app still owns `NavDisplay`.
 
 ```kotlin
 val state = rememberLiquidNav3State(
@@ -116,7 +175,8 @@ LiquidNav3TabScaffold(
 ```
 
 For native iOS 26 Liquid Glass tabs, keep `TabView` in SwiftUI and host Compose
-screens inside each tab.
+screens inside each tab. If you reuse a Compose tab scaffold there, pass an empty
+`bottomNavigation` slot so SwiftUI is the only tab bar.
 
 ## Build
 
@@ -138,7 +198,7 @@ iosApp/LiquidKitSample.xcodeproj
 
 ## Credits
 
-LiquidGlass's Android renderer includes source from
+LiquidKit's Android renderer includes source from
 [Kyant0/AndroidLiquidGlass](https://github.com/Kyant0/AndroidLiquidGlass).
 
 The optional Navigation 3 helper is adapted from the multiple-back-stack pattern

THIRD_PARTY_NOTICES.md

@@ -6,7 +6,7 @@ LiquidKit vendors Android Liquid Glass renderer and component source from:
 
 https://github.com/Kyant0/AndroidLiquidGlass
 
-Original author: Kyant
+Original author: Kyant
 License: Apache License 2.0
 
 The copied files live under: