android-design-guidelines

SKILL.md

Material Design 3 and Android platform guidelines for Jetpack Compose and XML layouts.

Implement dynamic color from user wallpaper (Android 12+) with static fallback; use semantic color roles (primary, secondary, tertiary, surface, error) instead of hardcoded hex values

Support all three window size classes (Compact < 600dp, Medium 600–839dp, Expanded 840dp+) with responsive layouts; use Navigation Bar for phones, Navigation Rail for tablets, and Permanent Drawer for large screens

Apply Material 3 typography scale (15 roles from displayLarge to labelSmall) using sp units; test at 200% font scale and support user bold text preferences

Ensure accessibility: 48dp minimum touch targets, 4.5:1 color contrast, contentDescription on all interactive elements, full TalkBack traversal, and custom canvas views using ExploreByTouchHelper

Opt into predictive back gesture (Android 13+) using BackHandler in Compose or OnBackInvokedCallback in View-based apps; enable edge-to-edge display with proper inset handling

Android Platform Design Guidelines — Material Design 3

1. Material You & Theming [CRITICAL]

1.1 Dynamic Color

Enable dynamic color derived from the user's wallpaper. Dynamic color is the default on Android 12+ and should be the primary theming strategy.