Files
DroidDeck/docs/development/themes.md
T

2.9 KiB
Raw Blame History

Themes

A theme is a Palette (ui/Theme.kt): a dark background scale (background, surface, surfaceVariant, line, line2), two text colours, and the accent: primary / signal (flat accent, also Material's primary), primary2 (the darker or second accent) and onPrimary. PrimaryButton and the launch flood already draw a gradient from primary to primary2. The choice is stored as an id (SessionPrefs.theme) and picked in Setup › Launcher.

Gradient theme

Themes.GRADIENT is the one of the theme whose colours the person picks: a primary and a secondary, kept in SessionPrefs.gradientColors and in Themes.gradientColors, a Compose state, so a change restyles the whole app at once. App.onCreate loads the saved colours; code outside a composition uses Themes.current(context).

ThemeColors.palette builds the full palette from the two colours: primary becomes primary / signal, secondary becomes primary2, the background scale is a dark neutral tinted with the primary's hue (plain grey for a grey primary), and onPrimary is dark or white by the luminance of the pair. A colour too dark to show on the dark background is lifted (ThemeColors.readable) rather than refused.

Setup shows Primary and Secondary under the theme when Gradient is chosen, each a small colour square. It opens ColorPickerDialog: a wheel (hue and saturation, touch), hue / saturation / brightness sliders (they work with a controller) and a hex box, with the old and new colour side by side. OK applies it.

Custom theme

Themes.CUSTOM stores a separate preference for every configurable palette colour: background, surfaces, borders, text, accent, button text, signals, success and error. SessionPrefs.customThemeColors restores the saved values, while Themes.customColors is Compose state so changes update the interface immediately.

The custom palette does not derive its surfaces from the accent. primary2 intentionally equals primary, keeping components that use the existing two-stop button and launch effects visually solid. The colour picker reused from Gradient supports the wheel, sliders and hexadecimal input.

Inner Gamer theme

Themes.INNER_GAMER is an RGB theme: the accent walks round the colour wheel. It sits just above Gradient in the list, and Setup shows a Speed slider (1 to 10, SessionPrefs.rgbSpeed) under the theme while it is chosen.

Themes.innerGamer(hue) builds the palette for one hue through ThemeColors.palette, so button text keeps the same contrast along the gradient at every hue. DroidDeckTheme runs one rememberInfiniteTransition while Inner Gamer is chosen, so the system's animation clock drives it. Compose applies Android's animator scale to it, and the colour holds still when animations are off in the app (Motion.scale) or in Android's own settings. The hue is written to Themes.rgbHue in 3° steps, which restyles the app only when the colour visibly moves; a slow cycle costs few recompositions.