---
title: "LocalRippleThemeConfiguration"
description: "The overall [RippleThemeConfiguration] in use by all built-in components and [ripple]."
type: "property"
---
## API Reference

> Source set: Common

```kotlin
public val LocalRippleThemeConfiguration: ProvidableCompositionLocal<RippleThemeConfiguration> =
    compositionLocalOf {
        RippleDefaults.ThemeConfiguration
    }
```

The overall [RippleThemeConfiguration](/jetpack-compose/androidx.compose.material3/material3/classes/RippleThemeConfiguration/api) in use by all built-in components and [ripple](/jetpack-compose/androidx.compose.material3/material3/functions/ripple/api).

By default, this will be `RippleDefaults.ThemeConfiguration`.

The ripple configuration is resolved as follows:
- [LocalRippleThemeConfiguration](/jetpack-compose/androidx.compose.material3/material3/properties/LocalRippleThemeConfiguration/api) provides the highest-level theming configuration for ripples,
including whether the focus indication is drawn by inset focus rings.
- [LocalRippleConfiguration](/jetpack-compose/androidx.compose.material3/material3/properties/LocalRippleConfiguration/api) provides hierarchical per-ripple configuration for [ripple](/jetpack-compose/androidx.compose.material3/material3/functions/ripple/api),
including disabling ripples and their indications. This takes next highest priority.
- [ripple](/jetpack-compose/androidx.compose.material3/material3/functions/ripple/api) parameters allow specifying configuration for individual indication callsites in
components.

## Code Examples

### InsetFocusRingRippleSample

```kotlin
@Preview
@Sampled
@Composable
fun InsetFocusRingRippleSample() {
    // Enable inset focus rings at theme level
    CompositionLocalProvider(
        LocalRippleThemeConfiguration provides RippleDefaults.InsetFocusRingThemeConfiguration
    ) {
        // Components in this tree will render inset focus rings using theme colors when focused
        Button(onClick = {}) { Text("Button with Inset Focus Ring") }
    }
}
```