Skip to content
AtsuraeDownload

Development sign-in

Only on a local server with DEV_AUTH. Enter any account name.

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.

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.

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.

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.

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.

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.

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.

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.