material-3-expressive
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, no
By albermonte · 398 installs
npx skills add albermonte/android-skills --skill material-3-expressive
Source repository · Upstream listing
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
1. Confirm intensity level + hero moments
2. Confirm device class + window size class
3. Load Tier 1 index and output template
4. Load component overview + token spec files
5. If theming needed, load Tier 3 foundation tokens
6. 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
[ ] Primary action identifiable within 2 seconds
[ ] Max 1 2 hero moments per screen
[ ] Labels preserved on all interactive elements
Accessibility
[ ] Color contrast: 4.5:1 text, 3:1 non text
[ ] Touch targets: 48dp minimum
[ ] Motion: reduced motion alternative provided
[ ] Screen reader: content descriptions present
Expressive Compliance
[ ] Intensity level consistent across feature
[ ] Standard patterns preserved
[ ] Dynamic color tokens used
[ ] Window size classes tested
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.