android-design-guidelines

Installation
Summary

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
SKILL.md

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
Related skills

More from ehmo/platform-design-skills

Installs
703
GitHub Stars
362
First Seen
Feb 1, 2026