Count badge

An avatar with an unread count badge that clamps large values to 9 plus.

Installation

caveui components are copy-paste Jetpack Compose built entirely on Material 3 — there's no caveui dependency to add. Make sure Material 3 is on your classpath (it ships with the Compose BOM), then copy the Usage snippet below into your project.

kotlin

// build.gradle.kts (module)
dependencies {
    implementation(platform("androidx.compose:compose-bom:2025.06.00"))
    implementation("androidx.compose.material3:material3")
}

Usage

kotlin

@Composable
fun CountAvatar(initials: String, count: Int) {
    val badge = Color(0xFFEF4444)
    Box(Modifier.size(48.dp)) {
        Box(
            Modifier.fillMaxSize().clip(CircleShape)
                .background(MaterialTheme.colorScheme.surfaceVariant),
            contentAlignment = Alignment.Center,
        ) {
            Text(initials, style = MaterialTheme.typography.titleSmall)
        }
        if (count > 0) {
            Box(
                Modifier.align(Alignment.TopEnd)
                    .defaultMinSize(18.dp, 18.dp)
                    .clip(CircleShape).background(MaterialTheme.colorScheme.background)
                    .padding(2.dp).clip(CircleShape).background(badge)
                    .padding(horizontal = 5.dp),
                contentAlignment = Alignment.Center,
            ) {
                Text(
                    if (count > 9) "9+" else "$count",
                    color = Color.White,
                    style = MaterialTheme.typography.labelSmall,
                )
            }
        }
    }
}