Color, opacity and shadow
Colors
Section titled “Colors”Colors are hex codes in sRGB:
| Format | Example | Meaning |
|---|---|---|
#RRGGBB |
#FF4F8B |
pink |
#RRGGBBAA |
#00000066 |
black at 40% opacity |
The # is optional, and upper- and lowercase both work. Transparency (AA) goes from 00 (invisible) to FF (solid). Some handy values:
| Alpha | Opacity |
|---|---|
FF |
100% |
CC |
80% |
99 |
60% |
80 |
50% |
66 |
40% |
40 |
25% |
1A |
10% |
Where colors go:
| Field | On | Default |
|---|---|---|
color |
text color, progress fill, line color | white |
fill |
inside of shapes | color, or white; no fill if the shape has a stroke |
stroke |
shape outline | none |
track |
unfilled part of a progress bar | #FFFFFF40 |
tint |
recolors an image (for single-color icons) | none |
The person’s color
Section titled “The person’s color”In Customize Widgets, people can pick a color for each widget. That color replaces:
- the
colorof text - the fill of progress bars and rings
- the
tintof tinted images
It doesn’t change shapes, progress tracks, or images without a tint. So design your widget so it looks right in white and in any color someone might pick: use color for the parts that should follow their choice, and fill/stroke for fixed parts like backgrounds.
Reset in Customize Widgets brings back your widget’s own colors.
Opacity
Section titled “Opacity”opacity makes a whole element transparent, from 0 (invisible) to 1 (solid, the default):
{ "text": "{weekday}", "opacity": 0.7 }Opacity is the easiest way to create hierarchy: keep the main value at 1 and secondary labels at 0.6–0.8. Unlike an alpha in color, it also survives the person picking a color.
Shadow
Section titled “Shadow”Every element has a soft dark shadow by default. It keeps white text readable on bright parts of a wallpaper without being noticeable on dark ones. Turn it off with:
"shadow": falseTurn it off for background shapes (a shadow behind a translucent card looks muddy) and for dark elements on light designs. See Readable on any wallpaper.
