---

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