Background pickerPro
Picture tiles we draw ourselves plus Your own, with Film, Static or Dither laid over the picture and a home screen preview.
oxyn add background-pickerBackground
Sits behind the home screen. Moving pictures play too.
Texture
Grain drawn over the picture. Press again for none.
The preview stays free for everyone. Pro opens the code of every Pro component, screen, agent-app template, block and kit, plus the Pro CLI.
Rendered from Rust at build time · goes live when visible
When to use
- Let someone put a picture behind their home screen, or their own, and lay a texture over it, seeing the result before leaving the page.
When not to use
- Eight mini-window swatches: use Theme grid instead.
- Oxyn original: use Theme split instead.
- Oxyn original: use Accent and density instead.
Installation
Background picker is part of Oxyn Pro; the preview is free. Pro items install with the oxyn CLI once your licence is signed in; until then Pro members copy the code from this page.
oxyn add background-pickerUsage
The preview is free. Pro opens the code of every Pro component, screen and template.
Examples
Default
Plain default picked: a home screen preview over six tiles, the last one for your own picture.
Background
Sits behind the home screen. Moving pictures play too.
Texture
Grain drawn over the picture. Press again for none.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Orbit with film
A drawn planet's edge behind the home screen with film grain laid over it.
Background
Sits behind the home screen. Moving pictures play too.
Texture
Grain drawn over the picture. Press again for none.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Neon dithered
Out-of-focus lights under an ordered dot texture.
Background
Sits behind the home screen. Moving pictures play too.
Texture
Grain drawn over the picture. Press again for none.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
Tiles only
No preview, two columns: the picker as it sits in a narrow settings pane.
Background
Sits behind the home screen. Moving pictures play too.
Texture
Grain drawn over the picture. Press again for none.
Code Pro
The preview is free. Pro opens the code of every Pro component, screen and template.
API reference
BackgroundPicker
| Prop | Type | Default | Description |
|---|---|---|---|
default_pick | String | "default" | Starting tile key (`default`, `canopy`, `orbit`, `neon`, `tide`). |
default_texture | String | "none" | Starting texture key (`none`, `film`, `static`, `dither`). |
preview | bool | true | The home screen preview above the tiles. |
cols | usize | 3 | Tile columns (2–4). |
on_change | EventHandler<(String, String)> | — | The background or texture changed: (tile key, texture key). |
Read from the Rust signature and doc comments.
Keyboard interactions
| Key | Action |
|---|---|
| Tab | Each tile, Your own, then each texture |
| EnterorSpace on a tile | Makes it the background |
| EnterorSpace on Your own | Opens the file picker |
| EnterorSpace on the lit texture | Takes the texture off |
Accessibility
- Tiles are a radio group; each picture is named and described in a few words.
- Your own is a real file input (images up to 8 MB); a wrong file says why in the live note.
- Each texture reports its state through aria-pressed; the preview is an image labelled with the picture and texture.
Responsive behaviour
- 560 px card; tiles drop to two columns and the texture row stacks under 480 px.
Edge cases (spec)
Tiles drop to two columns and the texture row stacks under 480 px.
Notes for AI
- Import
BackgroundPickerfromoxyn_dioxusand includeSTATUS_INDICATOR_CSSplus the token stylesheet once. - A GPUI version exists:
BackgroundPickerElinoxyn_gpui. - Keep its states and timings as they ship; restyle it through the CSS variables rather than by hand.