Material 3 Expressive (Android UI/UX)
Overview
Design and review Android UI/UX using Material 3 Expressive. Prioritize component-token requests for dialogs, sheets, modals, toolbars, and buttons, with guidance plus token references by default.
Intake Questions
- Target device class (phone, tablet, foldable, Wear OS)
- Window size class (Compact, Medium, Expanded)
- Brand constraints and dynamic color usage
- Primary action(s) and desired hero moments (1-2 max)
- Motion constraints and reduced-motion expectations
- Accessibility targets (contrast, touch target)
Default Assumptions
- Intensity level: Foundational
- Window size class: Compact
- Dynamic color: enabled
- Standard navigation patterns preserved
Quick Workflow
- Confirm intensity level + hero moments
- Confirm device class + window size class
- Load Tier 1 index and output template
- Load component overview + token spec files
- If theming needed, load Tier 3 foundation tokens
- Output: guidance + token refs (see template)
Default Output Format (Guidance + Token Refs)
Use references/m3-component-token-output-template.md verbatim as the base output shell.
- Context and intent (1-2 lines)
- Intensity level + hero moments (count + location)
- Window size class + device class
- Component + variant
- Token references: file paths + token groups to use (quote minimal key values only if needed)
- Compose mapping reference (optional):
references/compose-mapping.md
- Behavior or interaction constraints (from overview)
- Reduced-motion fallback note
- Accessibility and performance checks
- Optional: Compose mapping notes
Expressive Tactics
| Lever |
Application |
| Shape contrast |
Bold corners on primary, subtle on secondary |
| Rich color |
Primary/secondary containers for emphasis |
| Type hierarchy |
Size + weight variation |
| Motion |
Shape morph on press/select |
Constraint: Max 1-2 hero moments per flow
Expressive Intensity Levels
- Foundational: Clarity and familiarity first
- Excellent: Stronger color, type, and shape while preserving patterns
- Transformative: Bold layouts and motion with strict usability and accessibility
Common Mistakes
| Mistake |
Fix |
| Removing text labels for "cleaner" look |
Keep labels; usability drops without them |
| Too many hero moments per screen |
Limit to 1-2 per flow |
| Breaking navigation patterns |
Preserve standard nav behaviors |
| No reduced-motion fallback |
Honor system animation scale; provide reduced-motion or instant transitions when animation scale is 0 |
| Hardcoding token values |
Use semantic tokens (md.sys.color.*) |
| Ignoring window size classes |
Test Compact, Medium, Expanded |
Android-Specific Guidance
- Preserve navigation and component behaviors
- Keep touch targets generous and platform-consistent
- Honor system animation scale; provide reduced-motion alternatives or instant transitions when animation scale is 0
- Apply window size classes for tablets and foldables
Review Checklist
Hierarchy
Accessibility
Expressive Compliance
Reference Tiers (Load in Order of Need)
Tier 1: Always Load First
| Need |
File |
| Component token lookup |
references/m3-expressive-specs-tokens-index.md |
| Output format template |
references/m3-component-token-output-template.md |
| New/updated components |
references/m3-expressive-components.md |
Tier 2: Component-Specific (Load When Requested)
| Component |
Overview |
Tokens |
| Buttons |
m3-buttons.md |
m3-buttons-specs-tokens.md |
| Button Groups |
m3-button-groups.md |
m3-button-groups-specs-tokens.md |
| Dialogs |
m3-dialogs.md |
m3-dialogs-specs-tokens.md |
| Sheets |
m3-sheets.md |
m3-bottom-sheets-specs-tokens.md / m3-side-sheets-specs-tokens.md |
| Toolbars |
m3-toolbars.md |
m3-toolbars-specs-tokens.md |
| FABs |
m3-fabs.md |
m3-fabs-specs-tokens.md |
| Extended FAB |
m3-extended-fab.md |
m3-extended-fab-specs-tokens.md |
| FAB Menu |
m3-fab-menu.md |
m3-fab-menu-specs-tokens.md |
| Icon Buttons |
m3-icon-buttons.md |
m3-icon-buttons-specs-tokens.md |
| Split Button |
m3-split-button.md |
m3-split-button-specs-tokens.md |
| Navigation Bar |
m3-navigation-bar.md |
m3-navigation-bar-specs-tokens.md |
| Navigation Rail |
m3-navigation-rail.md |
m3-navigation-rail-specs-tokens.md |
| App Bars |
m3-app-bars.md |
m3-app-bars-specs-tokens.md |
| Carousel |
m3-carousel.md |
m3-carousel-specs-tokens.md |
| Progress Indicators |
m3-progress-indicators.md |
m3-progress-indicators-specs-tokens.md |
| Loading Indicator |
m3-loading-indicator.md |
m3-loading-indicator-specs-tokens.md |
Tier 3: Foundation Tokens (Load for Theming)
| Foundation |
File |
| Color system |
m3-color-system.md, m3-color-foundation-tokens.md |
| Typography |
m3-typography.md, m3-typography-foundation-tokens.md, m3-typography-fonts.md, m3-typography-type-scale-tokens.md |
| Shape |
m3-shape.md, m3-shape-foundation-tokens.md, m3-shape-corner-radius-scale.md, m3-shape-morph.md |
| Motion |
m3-motion-physics.md, m3-motion-foundation-tokens.md, m3-motion-specs.md |
| Elevation |
m3-elevation.md, m3-elevation-specs-tokens.md |
| State |
m3-state-foundation-tokens.md |
Tier 4: Evidence & Research (Load for Justification)
| Resource |
File |
| Research findings |
references/expressive-research.md |
| Testing guidance |
references/m3-testing-material-3.md |
| Expressive blog |
references/m3-expressive-blog.md |
| Expressive guidelines |
references/m3-expressive-guidelines.md |
| UX article |
references/medium-ux-article.md |
Tier 5: Wear OS (Load Only for Wearables)
| Resource |
File |
| Benefits |
references/wear-expressive-benefits.md |
| Levels of expression |
references/wear-levels-of-expression.md |
| Design language |
references/wear-expressive-design-language.md |
| Blog |
references/wear-expressive-blog.md |
| Compose Material3 |
references/wear-compose-material3.md |
Supporting Resources
| Resource |
File |
| Android UI design hub |
references/android-ui-design-hub.md |
| Expressive catalog |
references/expressive-catalog.md |
| Compose mapping |
references/compose-mapping.md |
Maintenance
- Refresh references with
skills/material-3-expressive/scripts/update_m3_expressive_refs.py.
- Requires Playwright and Chromium (
.venv/bin/python -m playwright install chromium if needed).
- CI runs weekly; local runs are for urgent changes.
Search Tips
- Find a token prefix:
rg "md.comp.button" skills/material-3-expressive/references/m3-buttons-specs-tokens.md
- Find navigation tokens:
rg "md.comp.navigation" skills/material-3-expressive/references/m3-.*navigation.*.md
Examples
- Use
assets/examples/ui/ExpressiveHomeScreen.kt as a Compose starting point
- Use
assets/examples/ui/ExpressiveButtonComparison.kt to see standard vs expressive button differences
- Use
assets/examples/ui/ExpressiveAntiPatterns.kt to learn common mistakes to avoid
- Use
assets/examples/ux/expressive-ux-brief-template.md to draft an expressive UX brief
- Examples are illustrative; adapt sizes/colors to expressive tokens and project constraints.
1---
2name: material-3-expressive
3description: Android UI/UX design or review with Material 3 Expressive (M3 Expressive / Material You Expressive). Use when selecting expressive component tokens, defining expressive hierarchy, motion, color, shape, typography, or reviewing Android UI against expressive guidance. Not for non-Android platforms, non-UI Android tasks, or implementation-only requests without design decisions.
4metadata:
5 source: https://skillmd.com/skills/albermonte/material-3-expressive
6---
7
8# Material 3 Expressive (Android UI/UX)
9
10## Overview
11
12Design and review Android UI/UX using Material 3 Expressive. Prioritize component-token requests for dialogs, sheets, modals, toolbars, and buttons, with guidance plus token references by default.
13
14## Intake Questions
15
16- Target device class (phone, tablet, foldable, Wear OS)
17- Window size class (Compact, Medium, Expanded)
18- Brand constraints and dynamic color usage
19- Primary action(s) and desired hero moments (1-2 max)
20- Motion constraints and reduced-motion expectations
21- Accessibility targets (contrast, touch target)
22
23## Default Assumptions
24
25- Intensity level: Foundational
26- Window size class: Compact
27- Dynamic color: enabled
28- Standard navigation patterns preserved
29
30## Quick Workflow
31
321. Confirm intensity level + hero moments
332. Confirm device class + window size class
343. Load Tier 1 index and output template
354. Load component overview + token spec files
365. If theming needed, load Tier 3 foundation tokens
376. Output: guidance + token refs (see template)
38
39## Default Output Format (Guidance + Token Refs)
40
41Use `references/m3-component-token-output-template.md` verbatim as the base output shell.
42
43- Context and intent (1-2 lines)
44- Intensity level + hero moments (count + location)
45- Window size class + device class
46- Component + variant
47- Token references: file paths + token groups to use (quote minimal key values only if needed)
48- Compose mapping reference (optional): `references/compose-mapping.md`
49- Behavior or interaction constraints (from overview)
50- Reduced-motion fallback note
51- Accessibility and performance checks
52- Optional: Compose mapping notes
53
54## Expressive Tactics
55
56| Lever | Application |
57|-------|-------------|
58| Shape contrast | Bold corners on primary, subtle on secondary |
59| Rich color | Primary/secondary containers for emphasis |
60| Type hierarchy | Size + weight variation |
61| Motion | Shape morph on press/select |
62
63**Constraint:** Max 1-2 hero moments per flow
64
65## Expressive Intensity Levels
66
67- **Foundational:** Clarity and familiarity first
68- **Excellent:** Stronger color, type, and shape while preserving patterns
69- **Transformative:** Bold layouts and motion with strict usability and accessibility
70
71## Common Mistakes
72
73| Mistake | Fix |
74|---------|-----|
75| Removing text labels for "cleaner" look | Keep labels; usability drops without them |
76| Too many hero moments per screen | Limit to 1-2 per flow |
77| Breaking navigation patterns | Preserve standard nav behaviors |
78| No reduced-motion fallback | Honor system animation scale; provide reduced-motion or instant transitions when animation scale is 0 |
79| Hardcoding token values | Use semantic tokens (`md.sys.color.*`) |
80| Ignoring window size classes | Test Compact, Medium, Expanded |
81
82## Android-Specific Guidance
83
84- Preserve navigation and component behaviors
85- Keep touch targets generous and platform-consistent
86- Honor system animation scale; provide reduced-motion alternatives or instant transitions when animation scale is 0
87- Apply window size classes for tablets and foldables
88
89## Review Checklist
90
91### Hierarchy
92- [ ] Primary action identifiable within 2 seconds
93- [ ] Max 1-2 hero moments per screen
94- [ ] Labels preserved on all interactive elements
95
96### Accessibility
97- [ ] Color contrast: 4.5:1 text, 3:1 non-text
98- [ ] Touch targets: 48dp minimum
99- [ ] Motion: reduced-motion alternative provided
100- [ ] Screen reader: content descriptions present
101
102### Expressive Compliance
103- [ ] Intensity level consistent across feature
104- [ ] Standard patterns preserved
105- [ ] Dynamic color tokens used
106- [ ] Window size classes tested
107
108## Reference Tiers (Load in Order of Need)
109
110### Tier 1: Always Load First
111| Need | File |
112|------|------|
113| Component token lookup | `references/m3-expressive-specs-tokens-index.md` |
114| Output format template | `references/m3-component-token-output-template.md` |
115| New/updated components | `references/m3-expressive-components.md` |
116
117### Tier 2: Component-Specific (Load When Requested)
118| Component | Overview | Tokens |
119|-----------|----------|--------|
120| Buttons | `m3-buttons.md` | `m3-buttons-specs-tokens.md` |
121| Button Groups | `m3-button-groups.md` | `m3-button-groups-specs-tokens.md` |
122| Dialogs | `m3-dialogs.md` | `m3-dialogs-specs-tokens.md` |
123| Sheets | `m3-sheets.md` | `m3-bottom-sheets-specs-tokens.md` / `m3-side-sheets-specs-tokens.md` |
124| Toolbars | `m3-toolbars.md` | `m3-toolbars-specs-tokens.md` |
125| FABs | `m3-fabs.md` | `m3-fabs-specs-tokens.md` |
126| Extended FAB | `m3-extended-fab.md` | `m3-extended-fab-specs-tokens.md` |
127| FAB Menu | `m3-fab-menu.md` | `m3-fab-menu-specs-tokens.md` |
128| Icon Buttons | `m3-icon-buttons.md` | `m3-icon-buttons-specs-tokens.md` |
129| Split Button | `m3-split-button.md` | `m3-split-button-specs-tokens.md` |
130| Navigation Bar | `m3-navigation-bar.md` | `m3-navigation-bar-specs-tokens.md` |
131| Navigation Rail | `m3-navigation-rail.md` | `m3-navigation-rail-specs-tokens.md` |
132| App Bars | `m3-app-bars.md` | `m3-app-bars-specs-tokens.md` |
133| Carousel | `m3-carousel.md` | `m3-carousel-specs-tokens.md` |
134| Progress Indicators | `m3-progress-indicators.md` | `m3-progress-indicators-specs-tokens.md` |
135| Loading Indicator | `m3-loading-indicator.md` | `m3-loading-indicator-specs-tokens.md` |
136
137### Tier 3: Foundation Tokens (Load for Theming)
138| Foundation | File |
139|------------|------|
140| Color system | `m3-color-system.md`, `m3-color-foundation-tokens.md` |
141| Typography | `m3-typography.md`, `m3-typography-foundation-tokens.md`, `m3-typography-fonts.md`, `m3-typography-type-scale-tokens.md` |
142| Shape | `m3-shape.md`, `m3-shape-foundation-tokens.md`, `m3-shape-corner-radius-scale.md`, `m3-shape-morph.md` |
143| Motion | `m3-motion-physics.md`, `m3-motion-foundation-tokens.md`, `m3-motion-specs.md` |
144| Elevation | `m3-elevation.md`, `m3-elevation-specs-tokens.md` |
145| State | `m3-state-foundation-tokens.md` |
146
147### Tier 4: Evidence & Research (Load for Justification)
148| Resource | File |
149|----------|------|
150| Research findings | `references/expressive-research.md` |
151| Testing guidance | `references/m3-testing-material-3.md` |
152| Expressive blog | `references/m3-expressive-blog.md` |
153| Expressive guidelines | `references/m3-expressive-guidelines.md` |
154| UX article | `references/medium-ux-article.md` |
155
156### Tier 5: Wear OS (Load Only for Wearables)
157| Resource | File |
158|----------|------|
159| Benefits | `references/wear-expressive-benefits.md` |
160| Levels of expression | `references/wear-levels-of-expression.md` |
161| Design language | `references/wear-expressive-design-language.md` |
162| Blog | `references/wear-expressive-blog.md` |
163| Compose Material3 | `references/wear-compose-material3.md` |
164
165### Supporting Resources
166| Resource | File |
167|----------|------|
168| Android UI design hub | `references/android-ui-design-hub.md` |
169| Expressive catalog | `references/expressive-catalog.md` |
170| Compose mapping | `references/compose-mapping.md` |
171
172## Maintenance
173
174- Refresh references with `skills/material-3-expressive/scripts/update_m3_expressive_refs.py`.
175- Requires Playwright and Chromium (`.venv/bin/python -m playwright install chromium` if needed).
176- CI runs weekly; local runs are for urgent changes.
177
178## Search Tips
179
180- Find a token prefix: `rg "md.comp.button" skills/material-3-expressive/references/m3-buttons-specs-tokens.md`
181- Find navigation tokens: `rg "md.comp.navigation" skills/material-3-expressive/references/m3-.*navigation.*.md`
182
183## Examples
184
185- Use `assets/examples/ui/ExpressiveHomeScreen.kt` as a Compose starting point
186- Use `assets/examples/ui/ExpressiveButtonComparison.kt` to see standard vs expressive button differences
187- Use `assets/examples/ui/ExpressiveAntiPatterns.kt` to learn common mistakes to avoid
188- Use `assets/examples/ux/expressive-ux-brief-template.md` to draft an expressive UX brief
189- Examples are illustrative; adapt sizes/colors to expressive tokens and project constraints.