ComposeShadowsPlus: Elevate your Android Compose UI with stunning custom shadows

AndroidTuts

1 year ago

ComposeShadowsPlus

ComposeShadowsPlus is a powerful Android Compose library that empowers developers with the ability to easily create and customize stunning, high-quality shadows for their UI elements.

Features:

Android Compose custom shadows with offset, color, and spread support.
NativePaint.setShadowLayer(...) & View.LAYER_TYPE_SOFTWARE based custom shadow.
RenderScript & ScriptIntrinsicBlur based custom shadow.
Advanced sample app.

Sample App

RSBlur	SoftLayer	Elevation

Download or clone this repository to discover the sample app.

Setup

Add to the root build.gradle.kts:allprojects { repositories { … maven(“https://jitpack.io”) } }

Add to the package build.gradle.kts:dependencies { implementation(“com.github.GIGAMOLE:ComposeShadowsPlus:{latest-version}”) }

Latest version is: .

Also, it’s possible to download the latest artifact from the releases page.

Guide

ComposeShadowsPlus provides two custom shadow Modifiers: RSBlurShadow and SoftLayerShadow

ComposeShadowsPlus common params:

Param	Description
radius	The shadow radius.
color	The shadow color.
shape	The shadow shape.
spread	The shadow positive or negative spread.
offset	The shadow offset.

ShadowsPlusDefaults contains default values of custom shadows.

You can use Modifier.shadowsPlus(...) to set the custom shadows with ShadowsPlusType enum.

RSBlurShadow

RSBlurShadow uses RenderScript and ScriptIntrinsicBlur to blur the shadow content to simulate the shadow.

RSBlurShadow more params:

Param	Description
alignRadius	The exponential align radius indicator.

To apply RSBlurShadow use Modifier.rsBlurShadow(...).

SoftLayerShadow

SoftLayerShadow uses NativePaint.setShadowLayer(...) to apply native shadow layer to the shadow content.

To render SoftLayerShadow, Android devices with API < 28(P), need to use View.LAYER_TYPE_SOFTWARE. It’s recommended to use SoftLayerShadowContainer to handle this automatically.

To apply SoftLayerShadow use Modifier.softLayerShadow(...).