Material Design 3 Expressive Documentation

This repository contains deeply detailed documentation on Material Design 3 Expressive, organized into nicely categorized markdown files.

Structure

• M3_Expressive_Documentation/
  • 01_Basics/: Introduction and setup guides.
  • 02_UX_UI_Guidelines/: Design philosophy based on Google's research and Liam Spradlin's podcast.
  • 03_Components/: Detailed reference for all new expressive components (shape morphing, wavy indicators, etc.) with code examples referenced from composables.com and official blogs.
  • 04_API_Reference/: Core APIs, advanced topics, and indices.
  • 05_Motion_and_Theming/: Theming system and motion scheme customization.
  • AGENTS.md: Instructions for AI agents working in this repository to enforce expressive design principles.
  • M3_Expressive_Skill.md: A standalone skill file defining the behavior of an AI agent to forcefully prioritize UX questioning and Material 3 Expressive components.

Sources

The content in this repository is derived and inspired by:

• Material 3 Expressive – Liam Spradlin Podcast
• Expressive Material Design - Google Research
• Composables.com - Material 3 Expressive Components
• Building with M3 Expressive
• M3 Expressive Motion & Theming