android-design-guidelines
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
displayLargetolabelSmall) usingspunits; test at 200% font scale and support user bold text preferences - Ensure accessibility: 48dp minimum touch targets, 4.5:1 color contrast,
contentDescriptionon all interactive elements, full TalkBack traversal, and custom canvas views usingExploreByTouchHelper - Opt into predictive back gesture (Android 13+) using
BackHandlerin Compose orOnBackInvokedCallbackin 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.
// Compose: Dynamic color theme
@Composable
fun AppTheme(
darkTheme: Boolean = isSystemInDarkTheme(),
dynamicColor: Boolean = true,
content: @Composable () -> Unit
) {
val colorScheme = when {
dynamicColor && Build.VERSION.SDK_INT >= Build.VERSION_CODES.S -> {
val context = LocalContext.current
More from ehmo/platform-design-skills
macos-design-guidelines
Apple Human Interface Guidelines for Mac. Use when building macOS apps with SwiftUI or AppKit, implementing menu bars, toolbars, window management, or keyboard shortcuts. Triggers on tasks involving Mac UI, desktop apps, or Mac Catalyst.
2.7Kios-design-guidelines
Apple Human Interface Guidelines for iPhone. Use when building, reviewing, or refactoring SwiftUI/UIKit interfaces for iOS. Triggers on tasks involving iPhone UI, iOS components, accessibility, Dynamic Type, Dark Mode, or HIG compliance.
921web-design-guidelines
Web platform design and accessibility guidelines. Use when building web interfaces, auditing accessibility, implementing responsive layouts, or reviewing web UI code. Triggers on tasks involving HTML, CSS, web components, WCAG compliance, responsive design, or web performance.
693ipados-design-guidelines
Apple Human Interface Guidelines for iPad. Use when building iPad-optimized interfaces, implementing multitasking, pointer support, keyboard shortcuts, or responsive layouts. Triggers on tasks involving iPad, Split View, Stage Manager, sidebar navigation, or trackpad support.
526watchos-design-guidelines
Apple Human Interface Guidelines for Apple Watch. Use when building watchOS apps, complications, or workout features. Triggers on tasks involving Watch UI, Digital Crown, glanceable interfaces, or wrist-based interactions.
464tvos-design-guidelines
Apple Human Interface Guidelines for Apple TV. Use when building tvOS apps with focus-based navigation, Siri Remote input, or living room viewing experiences. Triggers on tasks involving Apple TV, tvOS, 10-foot UI, or media playback.
439