Android Design System

---
name: android-design-system
description: "Enforce Material Design 3 and design token usage in Jetpack Compose apps. Use when implementing M3 components, color schemes, or design tokens in Android. (triggers: **/*Screen.kt, **/ui/theme/**, **/compose/**, MaterialTheme, Color, Typography, Modifier, Composable)"
---

# Android Design System (Jetpack Compose)

## **Priority: P2 (OPTIONAL)**

Enforce Material Design 3 tokens in Jetpack Compose. Use `MaterialTheme` for consistency.

## 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

- [Token & Theme Templates](references/implementation.md)
- [Usage Examples](references/example.md)