# Bundled Presets
TOML theme specifications loaded via `Theme::preset("name")`. Each file
defines a complete or near-complete theme with light and dark variants.
## Presets and platform readers
Each preset is a standalone theme specification: colors, fonts, geometry and
platform-specific values like `button_order`. Any app can load one and get a
resolved theme without needing a platform reader. `SystemTheme::from_system()`
selects a platform reader, one of the crate-internal `ThemeReader`
implementations `KdeReader` (and `GnomePortalKdeReader`, the KDE reader with
the portal's accent colour), `GnomeReader`, `MacosReader` and
`WindowsReader`, and merges the values it reads from the
operating system over its platform preset (`kde-breeze`, `adwaita`,
`windows-11`, and on macOS the preset of the running version's generation,
`macos-monterey` on 12 to 15 and `macos-tahoe` on 26 and later, by the
generation table in `pipeline.rs`); a field the reader does not provide keeps
the preset's value, and the resolve pipeline fills any remaining gaps.
`SystemTheme::version_match` reports a running version the preset was not
verified on (macOS 27 under `macos-tahoe` is `PresetOlder`), and
`SystemTheme::from_system_with_preset` merges over another generation of the
running platform instead, under the OS's live colours, fonts and
accessibility.
Gated sizes (padding sides, menu and list row heights, `list.header_height`,
toolbar `bar_height` and `item_gap`, tab `item_gap`, `active_indicator_width`
and `active_outward_corner_radius`, combobox `arrow_area_width`, expander
`arrow_gap` and `content_indent`, checkbox `radio_indicator_width`,
`radio_dot_diameter` and `check_mark_stroke_width`, switch
`unchecked_thumb_diameter`): a native
preset states one only where `docs/platform-facts.md` gives it for its
platform: KDE, GNOME, macOS, Windows or Material, whose column counts a
material-web or Compose implementation constant cited at a pinned line as
documented, as the KDE and GNOME columns count a Breeze or libadwaita source
constant. The colour-scheme presets, and the `ios-13` platform preset, which
has no platform-facts column, state none (`documented_sizes.rs` checks
both).
An unstated gated size resolves to `None` and the toolkit's own applies. The
presets' other sizes (`min_height_px`, `max_width_px`, …) are stated, often
without a source, and are still being audited against
`docs/platform-facts.md`; the colour-scheme presets state many of them too.
`tooltip.show_delay_ms` and `dialog.entrance` are gated the same way: a native
preset states each only as its platform's `docs/platform-facts.md` cell gives
it (§2.7, §2.22), and no other preset states one (`documented_sizes.rs`); the
macOS presets leave both unset, since AppKit states neither.
`material-3` and `ios-13` have no reader: `SystemTheme::from_system()` never
selects them, and an application chooses them as a look.
`material-3` is a look for any platform, and `list_presets_for_platform()`
offers it on every one; its icons are the bundled Material Symbols, which
load with the `material-icons` feature. `ios-13` is a look for desktop apps on
macOS: its icons are SF Symbols, which load only on macOS (with
`system-icons`). `list_presets_for_platform()` offers it on macOS and iOS and
`Theme::preset("ios-13")` loads it anywhere, but off macOS, iOS included, its
icons are `None`, never another set's.
Files: `kde-breeze.toml`, `macos-monterey.toml`, `macos-tahoe.toml`, `windows-11.toml`,
`adwaita.toml`, `material-3.toml`, `ios-13.toml`, and the community presets
(`catppuccin-*.toml`, `dracula.toml`, `gruvbox.toml`, `nord.toml`,
`one-dark.toml`, `solarized.toml`, `tokyo-night.toml`).
## Naming a platform preset
One platform preset per visual generation. Its key is the vendor's own name
for the generation's first OS version: Apple's codename (`macos-monterey`, `macos-tahoe`),
Microsoft's version number (`windows-11`), Material's design version
(`material-3`). The file's first lines state which OS versions the preset
covers and which versions its values were verified on, matching the version
tags of `docs/platform-facts.md`; a header states them only once they have
been checked against the platform's sources, and until then names the
generation alone. A new generation is a new preset under its own key; a new
OS version of the same generation updates the existing one. The style
presets keep their style names, `kde-breeze` and `adwaita`, and their
headers name the style version they pin (Breeze v6.7.5, libadwaita
1.10.0, checked against the latest released Breeze and libadwaita on
2026-10-11), since the KDE
and GNOME readers read the installed style, and the style, not the
desktop's version, is the generation. The iOS preset follows the rule as
well: `ios-13` carries the flat look iOS 13 introduced, unchanged to iOS 18,
its header naming the version its values were verified on.
## Preset file listing
| `adwaita.toml` | GNOME/Adwaita standalone theme |
| `catppuccin-frappe.toml` | Catppuccin Frappe color scheme |
| `catppuccin-latte.toml` | Catppuccin Latte color scheme |
| `catppuccin-macchiato.toml` | Catppuccin Macchiato color scheme |
| `catppuccin-mocha.toml` | Catppuccin Mocha color scheme |
| `dracula.toml` | Dracula color scheme |
| `gruvbox.toml` | Gruvbox color scheme |
| `ios-13.toml` | iOS standalone theme, the flat look of iOS 13 to 18 |
| `kde-breeze.toml` | KDE Breeze standalone theme |
| `macos-monterey.toml` | macOS standalone theme, Monterey (12) to Sequoia (15) |
| `macos-tahoe.toml` | macOS standalone theme, Tahoe (26) |
| `material-3.toml` | Material Design standalone theme |
| `nord.toml` | Nord color scheme |
| `one-dark.toml` | One Dark color scheme |
| `solarized.toml` | Solarized color scheme |
| `tokyo-night.toml` | Tokyo Night color scheme |
| `windows-11.toml` | Windows 11 standalone theme |
## What each reader supplies
The platform readers supply these fields over the platform preset, and
`resolve_platform_defaults` the dialog's button order where a theme states
none:
- **`button_order`** -- stated by every platform preset in both variants
(`primary_left` in `kde-breeze` and `windows-11`, `primary_right` in the
others), and read by no reader; `resolve_platform_defaults` fills it only
for a theme that states none, the colour-scheme presets, from the detected
desktop (`platform_button_order` in `resolve/inheritance.rs`: primary-left
on KDE and Windows, primary-right elsewhere)
- **`icon_theme`** -- stated by every preset, at the Theme level by all but
`kde-breeze`, which states it per variant (`breeze`, `breeze-dark`). The
KDE reader replaces it in the variant it reads, from `kdeglobals`'
`[Icons] Theme`, and the GNOME reader from the `icon-theme` gsetting; the
macOS and Windows readers read none. A variant's own value comes first,
then the Theme-level one, then the detected system theme (`pipeline.rs`)
- **`font_dpi`** -- filled by the platform reader: 96 on every Linux desktop,
KDE's and GNOME's alike, since the toolkit's scale factor already carries
the display's scale (GNOME's text-scaling factor goes to
`text_scaling_factor`, not into the DPI; on a GNOME or Budgie X11 session
the reader reports a `text_scaling_factor` of 1.0 instead: winit and gpui
take their X11 scale factor from the `Xft.dpi` gnome-settings-daemon
writes with the factor in it, so the connectors' text scaling would apply
it twice, as `GnomeReader`'s doc in `gnome/mod.rs` says), macOS's a fixed
72, and Windows' a fixed 96, since it reads its fonts at 96 DPI so that
they resolve to logical pixels
- **`reduce_motion`**, **`high_contrast`**, **`reduce_transparency`**,
**`text_scaling_factor`** -- filled by platform reader from OS
accessibility settings (the macOS reader reports no text-scaling factor:
its text size setting reaches only a few Apple apps,
`docs/platform-facts.md` §2.1.7)
- **`icon_sizes`** -- stated by every platform preset; the KDE reader replaces
them from the icon theme's `index.theme`