Overview / Guide
Shape the appearance
Use platform themes, then choose how your app follows light, dark and device colors.
The standard setup combines the iOS 27 and Material Design 3 themes. Start there for a new integration; use the individual theme guides when adding only a theme to an existing app.
Themes style your Web UI. Dynamic Color obtains the Android palette through the plugin and applies it through the Material Design theme. Keep one owner for the app’s appearance preference, including when the app chooses a different mode from the device.
Choose the appearance owner
For an app that follows the device, standard setup uses the theme controller in system mode. If your app already offers light, dark or system preferences, keep that preference as the source of truth and connect Dynamic Color to it. Do not add another system-mode controller beside it.
Separate mode from palette
Light or dark is the app’s appearance choice; Dynamic Color supplies the available Android colors. Apply colors for the app’s selected mode, even when it differs from the device. On devices without Dynamic Color, keep the theme’s fallback palette. Check both modes and the fallback rather than testing only the device’s current colors.