material-design

name	material-design
description	Guide for implementing Material Design 3 (Material You). Use when designing Android apps, implementing dynamic theming, or following Material component patterns.

Material Design 3 (Material You)

Apply Google's Material Design 3 principles when designing and developing user interfaces with emphasis on personalization, accessibility, and cross-platform consistency.

When to Activate

Use this skill when:

• Designing or implementing Android applications
• Building web applications following Material Design
• Working with Flutter or Jetpack Compose
• Implementing dynamic theming and color systems
• Creating Material components
• Reviewing designs for Material Design compliance

What is Material Design 3?

Material Design 3 (Material You) represents Google's latest design system with:

• Personalization: Dynamic color extraction from user preferences
• Expressiveness: Softer, rounded components with visual hierarchy
• Adaptability: Responsive across devices and platforms
• Accessibility: Built-in inclusive design features

Key Differences from Material Design 2

Aspect	MD2	MD3
Colors	Fixed brand palettes	Dynamic, user-generated schemes
Customization	Limited theming	Highly personalized
Components	Flat, rigid shapes	Rounded, expressive
Accessibility	Basic support	Priority built-in

Core Foundations

1. Dynamic Color System

Material Design 3 uses HCT (Hue, Chroma, Tone) color space for perceptually accurate color generation.

Key concepts:

• Color roles (primary, secondary, tertiary, error, neutral)
• Tonal palettes (50-99 tones per color)
• Automatic light/dark theme generation
• User-driven personalization from wallpaper/system

2. Typography

Type scale with 5 display sizes and 9 text sizes:

Quick example:

• Display Large: 57sp
• Headline Large: 32sp
• Body Large: 16sp
• Label Small: 11sp

3. Layout

Responsive breakpoints and grid system:

• Compact: 0-599dp (phones)
• Medium: 600-839dp (tablets, folded phones)
• Expanded: 840dp+ (desktops, large tablets)

Component Guidelines

Material Design 3 provides specifications for:

• Common Buttons: Elevated, Filled, Tonal, Outlined, Text
• Cards: Elevated, Filled, Outlined variants
• Text Fields: Filled, Outlined with labels and helper text
• Navigation: Navigation bar, rail, drawer
• Chips: Assist, Filter, Input, Suggestion chips
• Dialogs: Basic, Full-screen dialogs

Full specifications for every component live at m3.material.io (linked under Resources).

Quick Component Examples

Buttons

// Jetpack Compose
Button(onClick = { }) {
    Text("Filled Button")
}

OutlinedButton(onClick = { }) {
    Text("Outlined Button")
}

Cards

Card(
    modifier = Modifier.fillMaxWidth(),
    elevation = CardDefaults.cardElevation(defaultElevation = 6.dp)
) {
    Column(modifier = Modifier.padding(16.dp)) {
        Text("Card Title", style = MaterialTheme.typography.headlineSmall)
        Text("Card content", style = MaterialTheme.typography.bodyMedium)
    }
}

Text Fields

OutlinedTextField(
    value = text,
    onValueChange = { text = it },
    label = { Text("Label") },
    supportingText = { Text("Helper text") }
)

Implementing Dynamic Color

Android (Jetpack Compose)

val dynamicColor = Build.VERSION.SDK_INT >= Build.VERSION_CODES.S

val colorScheme = when {
    dynamicColor && darkTheme -> dynamicDarkColorScheme(LocalContext.current)
    dynamicColor && !darkTheme -> dynamicLightColorScheme(LocalContext.current)
    darkTheme -> darkColorScheme()
    else -> lightColorScheme()
}

MaterialTheme(
    colorScheme = colorScheme,
    typography = Typography,
    content = content
)

Web

Use Material Web Components (linked under Resources) for web implementation.

Motion and Animation

Material Design 3 motion principles:

• Easing: Standard, emphasized, decelerated curves
• Duration: Based on travel distance and complexity
• Choreography: Coordinated element movements

Accessibility

Material Design 3 prioritizes accessibility:

• Minimum 4.5:1 contrast ratio (text)
• 3:1 contrast ratio (UI components)
• Touch targets minimum 48dp × 48dp
• Screen reader support
• Semantic color usage (not color-only indicators)

Load /core:accessibility for WCAG implementation guidance.

Key Principles

• User-driven personalization: Colors adapt to user preferences
• Expressive and flexible: Rounded corners, dynamic elevation
• Accessible by default: Built-in contrast, touch targets, semantics
• Cross-platform consistency: Same principles across Android, web, iOS
• Design tokens: Use semantic tokens, not hardcoded values
• Responsive: Adapt to device size and orientation

Resources

• Material Design 3: https://m3.material.io/
• Material Theme Builder: https://m3.material.io/theme-builder
• Jetpack Compose: https://developer.android.com/jetpack/compose/designsystems/material3
• Material Web Components: https://github.com/material-components/material-web
• Flutter Material 3: https://flutter.dev/docs/development/ui/material