Readable on any wallpaper
Your widget will sit on wallpapers you’ve never seen: bright beaches, black nebulas, moving video. These habits keep it readable on all of them.
Keep the shadow
Section titled “Keep the shadow”Every element has a soft dark shadow unless you set "shadow": false. It’s subtle on dark wallpapers and makes white text readable on bright ones. Leave it on for text, icons and progress bars. Turn it off only for background shapes.
Use white, with opacity for hierarchy
Section titled “Use white, with opacity for hierarchy”White text with a shadow works on nearly every wallpaper. For secondary text, lower the opacity (0.6–0.8) rather than choosing gray. It stays in harmony with whatever is behind it, and it still works when people pick their own color.
Give busy wallpapers a backdrop
Section titled “Give busy wallpapers a backdrop”For widgets with small text or lots of detail, put a translucent card behind them:
{ "type": "shape", "size": [0.3, 0.16], "cornerRadius": 0.024, "fill": "#00000059", "shadow": false }Black at 25–40% opacity calms busy backgrounds without looking heavy. A thin light outline ("stroke": "#FFFFFF26") adds definition on dark wallpapers.
Size up
Section titled “Size up”Desktop widgets are read from a distance and at a glance. As a rule of thumb:
| Role | font.size |
|---|---|
| Minimum for anything | 0.011 |
| Labels | 0.011–0.014 |
| Body | 0.016–0.022 |
| Main value | 0.03 and up |
Small text benefits from "weight": "medium" or heavier, and wide letter spacing (tracking: 0.15–0.25) for uppercase labels.
Prefer thin over light on big text
Section titled “Prefer thin over light on big text”Huge numbers (0.1 and up) look elegant in ultraLight or thin, but those weights disappear at small sizes. Use them only for large text.
Respect the person’s color
Section titled “Respect the person’s color”People can recolor your widget. If parts of your design must stay a fixed color (a red recording dot, a brand logo), use shapes or untinted images, which keep their colors. Text, progress fills and tinted icons follow the person’s choice.
Keep the center calm
Section titled “Keep the center calm”Many wallpapers have their subject in the middle. Design widgets that work in a corner or along an edge, and keep them compact so people can tuck them away.
Try your widget on all four built-in wallpapers (Liquid, Aurora, Dusk Waves and Nebula), on a bright photo, and on a white image. The Customize Widgets preview uses the current wallpaper, so switching wallpapers is a quick test.
