> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Bach builds Windows installers from one bach.toml with the bach command: bach init, bach check, bach preview, bach build. Installs are per user and need no administrator rights by default. installer.scope = "machine" installs for every user after one Windows prompt. On Windows, run setup files with Start-Process -Wait -PassThru in PowerShell, and give signtool arguments that start with the word sign.

# [style]: built-in styles, fonts, colours and backgrounds

> Pick one of 14 built-in styles for the Bach installer window with installer.style, then change its fonts, colours, corners, gradient and background picture.

The installer window comes in 14 built-in styles. Pick one with `installer.style`, then change whatever you like in `[style]`: the font, every colour, the corners, a gradient or a picture behind the window. Every setting is optional. The window's size, arrangement and animation are in [`[layout]`](/docs/reference/config/layout).

```toml bach.toml theme={"theme":{"light":"github-light","dark":"github-dark"}}
[installer]
style = "arcade"
```

[`bach styles`](/docs/reference/cli/styles) lists them, and `bach preview --style NAME` shows one on your own app without changing `bach.toml`.

## Built-in styles

| Style | What it looks like | Suits |
| - | - | - |
| `bach` | Bach's own look: white or graphite, black buttons, Inter. The default. | any app |
| `aurora` | A soft violet-to-blue wash, frosted cards and pill buttons. | Tauri, Electron, Wails and Flutter apps |
| `terminal` | A monospaced face (Cascadia Mono), near-black with a green glow on every edge, and a green prompt. Dark by default. | command-line tools |
| `arcade` | Neon pink on a deep violet glow, with a heavy heading and a dark-on-pink button. Dark by default. | indie and web-tech games |
| `forge` | Brushed steel and molten orange, with tight corners. Dark by default. | 3D games made with Unity or Unreal |
| `lagoon` | Calm sea blue on a pale wash, rounded and friendly. | games and tools made with Godot |
| `pixel` | Square corners, a monospaced face, a night-blue screen and a warm gold frame. Dark by default. | pixel-art and retro games |
| `midnight` | Deep navy fading to black, blue-tinted glass cards and an electric blue button. Dark by default. | developer tools |
| `paper` | Warm paper, a serif heading (Georgia) and a terracotta accent. | writing, reading and note apps |
| `ember` | Charcoal with a warm amber glow. Dark by default. | audio, video and creative tools |
| `forest` | Moss and sage on a soft green wash, cream cards and pill buttons. | productivity, health and outdoor apps |
| `blossom` | Soft pink, generous corners and pill buttons. | friendly consumer apps |
| `mono` | Black and white only: hairlines, small corners and a heavy heading. | strict, plain utilities |
| `frost` | Cool blue-grey, calm and quiet. | system utilities, backup and sync tools |

Every style has a light and a dark version and follows `installer.theme`. The ones marked "dark by default" start dark when `theme` isn't set. Each uses fonts every Windows 10 and 11 PC has (Cascadia Mono or Consolas, Bahnschrift, Georgia) and falls back to Inter, which every setup file carries, when one is missing.

> [!NOTE]
>
> The default is always `bach`, whatever kind of app you ship. [`bach init`](/docs/reference/cli/init) doesn't pick a style for you. The "Suits" column is only a hint: any style works for any app, and you switch by setting `installer.style` yourself.

## Your own look

Everything in `[style]` goes on top of the chosen style. Colours set in `[style]` apply in light and dark mode. `[style.light]` and `[style.dark]` set them for one mode and win.

```toml bach.toml theme={"theme":{"light":"github-light","dark":"github-dark"}}
[installer]
style = "aurora"

[style]
font = "fonts/Outfit.ttf"       # or a font Windows has, like "Segoe UI"
heading_weight = 700
radius = 20
button_radius = 16              # pill buttons
accent = "#22d3ee"
background_image = "art/backdrop.png"
background_image_opacity = 0.4

[style.dark]
background = ["#1d0b36", "#0a0416"]   # a gradient from top to bottom
card = "#ffffff0b"                    # the window shows through

[style.light]
background = "#ffffff"
text = "#1b1b1b"
```

### Fonts, corners and picture

| Setting | Default | Meaning |
| - | - | - |
| `font` | the style's | The text's font: a family Windows has, like `"Segoe UI"`, or a `.ttf` or `.otf` file in your project, which ships in the setup file. A list of files (`["fonts/Nunito-Regular.ttf", "fonts/Nunito-Bold.ttf"]`) ships several cuts of one family. A family the PC doesn't have falls back to the style's font, then Inter. Web fonts (`.woff`, `.woff2`) and collections (`.ttc`) aren't supported. Up to 4 MB per file. |
| `heading_font` | `font`, else the style's | The headings' font, in the same forms as `font`. |
| `heading_weight` | the style's, or the heaviest font file's | 100 to 900: 400 regular, 600 semibold, 700 bold. |
| `radius` | the style's | Corners of the card, the license box and the key field, 0 (square) to 24 points. |
| `button_radius` | the style's | Corners of buttons, icon wells and checkboxes, 0 to 16 points. 16 makes pill buttons. |
| `background_image` | none | A PNG or JPEG drawn over the background colour, covering the window (up to 8 MB). Pick a calm picture: the text sits on it. |
| `background_image_opacity` | `0.35` | How strongly the picture shows, 0 to 1. |

### Colours

Colours are `#rrggbb`, or `#rrggbbaa` to let what's behind show through. Set them in `[style]`, `[style.light]` or `[style.dark]`.

| Setting | Default | Meaning |
| - | - | - |
| `background` | the style's | The window's colour, or two colours for a gradient from top to bottom. Opaque only. |
| `card` | the style's | The card of choices, the license box and the key field. |
| `text` | the style's | Headings and labels. |
| `muted_text` | the style's | Descriptions, the subtitle and the footer. |
| `accent` | the style's | Buttons, the progress bar and ticked boxes. Same as `installer.accent`: set one of them, not both. |
| `accent_text` | black or white | Text on the accent. By default whichever reads. |
| `border` | the style's | The card's edges and its dividers. |
| `error` | the style's | The remove button and failure icons. |
| `mark` | the text colour or the accent | The Bach mark and one-colour (SVG) logos. Styles that colour the mark keep it in the accent, also when you change the accent. On a `panel_image` it is light, like the heading. |
| `panel` | a light tint of the accent | The panel of [`[layout]`](/docs/reference/config/layout) where it shows no picture. |
| `panel_text` | whatever reads on the panel | The heading and subtitle on that panel; light on a `panel_image`. |

The quieter colours (icon wells, hover washes, the progress track, checkbox edges) are mixed from these, so the window stays consistent whatever you set.

> [!NOTE]
>
> The logo, fonts and picture may take 16 MB together. They are stored after the logo in the setup file, so a setup file without them is built exactly as before.

## Check the result

`bach check` and `bach build` show the look in one line:

```console theme={"theme":{"light":"github-light","dark":"github-dark"}}
$ bach check
  ...
  Look         arcade style, dark, font Outfit, own colours, own corners, 1 font file, background picture
```

Every mistake names its setting, and a misspelt style gets a suggestion:

```console theme={"theme":{"light":"github-light","dark":"github-dark"}}
$ bach check
Error: bach.toml isn't valid.
  installer.style is "arcde"; did you mean "arcade"? (`bach styles` lists them all)
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.