Components

<background>

Root-level background element rendered behind all pages. Use for the wallpaper's base color or gradient.

<layer>

Full-screen stacking container. Page-specific layers render on their page only.

<column>

Vertical flex container — children stack top to bottom.

<row>

Horizontal flex container — children flow left to right.

<box>

Stacking container — children overlap at the specified alignment. `align` controls how the box places itself in its parent (Compose `Modifier.align`); `contentAlignment` controls how children are placed inside the box (Compose `Box(contentAlignment = ...)`).

<polar>

Radial layout — places children at equal angular intervals on a circle of the given ring radius. Powers astrolabes, clock faces, and radial menus.

<spacer>

Flexible empty space for distributing layout.

<text>

Text display with M3 typography presets, expressions, and styling.

<icon>

Material icon from the curated icon registry.

<image>

Displays a local or remote image with expression-driven source, sizing, and styling.

<shape>

Decorative geometric shape — rectangle, circle, or line. Supports both fill (`color`) and stroke (`strokeColor`/`strokeWidth`) — either, both, or neither.

<divider>

Horizontal separator line.

<progressbar>

Horizontal linear progress indicator.

<circularprogress>

Circular progress indicator.

<arc>

Arc gauge for circular data visualization.

<path>

Vector path drawn from an SVG-subset `d` attribute (M/L/H/V/C/Z). Use for constellations, decorative flourishes, and bespoke shapes.

<skyplot>

Draws the visible ecliptic arc as a sine-wave curve with solar-system bodies (Sun, Moon, planets) plotted at their true sky positions. Requires a <module type="solarsystem" /> declaration.

<effect>

Generative animated background effect. Picks one of a fixed catalog of templates (particles, blobs, topography, aurora) and renders it on a Compose Canvas driven by the shared animation clock. Pauses when the wallpaper engine is not visible. Allowed wherever a <shape> is — typically inside <background> or a <layer>.

<conditional>

Conditionally render children based on an expression result.

<button>

Tappable button. Widgets only.

<tap>

Invisible tap region wrapping children. Widgets only.