diff --git a/README.md b/README.md
index 65bda0a7..07547f22 100644
--- a/README.md
+++ b/README.md
@@ -41,12 +41,19 @@ developers build complex settings screens without all the boilerplate.
|-----------------------------------|----------------------------------------------------------------|
| [SettingsSlider](#SettingsSlider) |
|
+**Ui tiles expressive**
+
+| Component | Screenshot |
+|---------------------------------------------|----------------------------------------------------------------|
+| [SettingsButtonGroup](#SettingsButtonGroup) |
|
+
## Install
```
##// groovy
implementation 'com.github.alorma.compose-settings:ui-tiles:$version'
implementation 'com.github.alorma.compose-settings:ui-tiles-extended:$version'
+implementation 'com.github.alorma.compose-settings:ui-tiles-expressive:$version'
[...]
@@ -54,6 +61,7 @@ implementation 'com.github.alorma.compose-settings:ui-tiles-extended:$version'
implementation("com.github.alorma.compose-settings:ui-tiles:$version")
implementation("com.github.alorma.compose-settings:ui-tiles-extended:$version")
+implementation("com.github.alorma.compose-settings:ui-tiles-expressive:$version")
[...]
@@ -65,6 +73,7 @@ compose-settings = "{{libVersion}}"
[libraries]
composeSettings-ui = { group = "com.github.alorma.compose-settings", name = "ui-tiles", version.ref = "compose-settings" }
composeSettings-ui-extended = { group = "com.github.alorma.compose-settings", name = "ui-tiles-extended", version.ref = "compose-settings" }
+composeSettings-ui-expressive = { group = "com.github.alorma.compose-settings", name = "ui-tiles-expressive", version.ref = "compose-settings" }
```
## Usage
@@ -186,3 +195,23 @@ SettingsGroup(
```
+
+##### SettingsButtonGroup
+
+> Requires Material 3 Expressive components (uses `OutlinedToggleButton` from Material 3 Expressive API).
+
+```kotlin
+SettingsButtonGroup(
+ title = { Text(text = "Setting title") },
+ items = listOf(1, 2, 3),
+ selectedItem = 2,
+ itemTitleMap = { item -> "#$item" },
+ onItemSelected = { selectedItem -> },
+ modifier = Modifier,
+ enabled = false / true,
+ subtitle = { Text(text = "Setting subtitle") },
+ icon = { Icon(...) },
+)
+```
+
+