android-design-system

name	android-design-system
description	Enforce Material Design 3 theming and design token usage in Jetpack Compose. Use when implementing M3 components, color schemes, typography, or design tokens.
metadata	{"triggers":{"files":["**/*Screen.kt","**/ui/theme/**","**/compose/**"],"keywords":["MaterialTheme","Color","Typography","Modifier","Composable"]}}

Android Design System (Jetpack Compose)

Priority: P2 (MEDIUM)

Guidelines

Define Color.kt, Theme.kt, and Type.kt in ui/theme/. Map every raw color/type value to lightColorScheme/darkColorScheme slots. Access all tokens through MaterialTheme:

• Colors → MaterialTheme.colorScheme.*
• Text styles → MaterialTheme.typography.*
• Spacing → .dp units consistently

Anti-Patterns

• No Hardcoded Colors: Use MaterialTheme.colorScheme.*, not Color(0xFF...).
• No Inline Typography: Use MaterialTheme.typography.*, not raw fontSize = 32.sp.
• No Magic Spacing: Prefer named .dp tokens; avoid unexplained magic numbers.

References