> ## 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.

# Customize the installer window: logo, accent, theme and texts

> Set your logo, accent colour, theme, languages, license page and every text in the Bach installer window, in one language or per language.

The installer window is one calm column: your logo, a heading, one line of copy, a card of choices and buttons at the bottom. You change how it looks and what it says in `[installer]`, `[app]` and `[text]`. This page walks through each lever.

## Logo and icon

```toml bach.toml theme={"theme":{"light":"github-light","dark":"github-dark"}}
[app]
icon = "assets/app.ico"     # setup file icon, window icon, and logo if it holds a PNG

[installer]
logo = "assets/logo.svg"    # .svg, .png, or "none"
logo_height = 56            # points, 32 to 96
```

* `app.icon` is a `.ico` file. It becomes the setup file's icon and the window's icon. When the icon holds a PNG image (most modern icons do) and `installer.logo` is not set, it is also the logo in the window. Include sizes 16 to 256 for crisp results.
* `installer.logo` is an `.svg` or `.png`, or `"none"` for no logo at all. If you set neither, the window shows the Bach mark.
* An SVG is drawn in one colour that follows the theme. Use a PNG for a full-colour logo. A wide PNG, such as a wordmark, keeps its shape. Give a PNG twice the size it is shown at for sharp results.

## Style

The window comes in 14 built-in styles: Bach's own, soft gradients, a terminal look, several game looks and more. Every app starts in Bach's own style, `bach`. If you want another, pick one, and change its font, colours, corners or background in `[style]`:

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

[style]
font = "fonts/Outfit.ttf"       # or a font Windows has
accent = "#22d3ee"
background_image = "art/backdrop.png"
```

`bach styles` lists them, and `bach preview --style NAME` shows one on your app without changing `bach.toml`. Every setting is in [`[style]`](/docs/reference/config/style).

## Layout

Start from one of ten layouts, such as `showcase` (the choices on the left, a large rounded picture on the right), `hero`, `floating` or `tiles`, then change the window's size, the panel, spacing, buttons and animation:

```toml bach.toml theme={"theme":{"light":"github-light","dark":"github-dark"}}
[layout]
preset = "showcase"
panel_image = "art/hero.jpg"
heading_size = 34
```

`bach layouts` lists them and `bach preview --layout NAME` shows one on your app. Every setting is in [`[layout]`](/docs/reference/config/layout).

## Theme and accent

```toml bach.toml theme={"theme":{"light":"github-light","dark":"github-dark"}}
[installer]
theme = "system"     # system, light or dark
accent = "#2563eb"   # buttons, progress bar, ticked boxes
```

`system` follows Windows' light or dark setting, live. `light` or `dark` fixes it. Without `accent`, buttons are black in light mode and white in dark mode. With one, the accent replaces the primary colour of the window, and the button text automatically picks black or white for contrast.

## Languages

```toml bach.toml theme={"theme":{"light":"github-light","dark":"github-dark"}}
[installer]
languages = ["en", "de"]
```

The window ships in 19 languages and follows the user's Windows display language when it is in your list, otherwise it uses your first language. With a single language, such as `["de"]`, the window always speaks it. Leave `languages` out to offer all 19.

| Code | Language | Code | Language |
| - | - | - | - |
| `en` | English | `tr` | Türkçe |
| `de` | Deutsch | `ja` | 日本語 |
| `nl` | Nederlands | `ko` | 한국어 |
| `fr` | Français | `zh` | 简体中文 |
| `es` | Español | `pt` | Português |
| `it` | Italiano | `pl` | Polski |
| `ru` | Русский | | |

Preview any language without changing Windows: `bach preview --lang de`.

## License page

```toml bach.toml theme={"theme":{"light":"github-light","dark":"github-dark"}}
[installer]
license = "LICENSE.txt"
# or one file per language:
# license = { en = "LICENSE.txt", de = "LIZENZ.txt" }
```

The license file is UTF-8 text. The user must accept it before the install page. An update shows it again only when it changed.

## Change any text

Every word the window shows can be replaced in `[text]`, in one language or per language:

```toml bach.toml theme={"theme":{"light":"github-light","dark":"github-dark"}}
[text]
install_title = { en = "Get {name}", de = "Hol dir {name}" }
install_subtitle = "The fastest way to write things down."
footer = "Made with care by {publisher}"
```

Every text can use `{name}`, `{version}` and `{publisher}`. A few have their own placeholders. The complete list of text names, their English defaults and their placeholders is in [`[text]`](/docs/reference/config/text).

> [!NOTE]
>
> When the window speaks several languages and a text is given in only one, `bach check` points it out.

## Where the app's description shows

`app.description` is one line. It is the shortcut's tooltip, and the line under "Install My App" on the first page, unless `[text] install_subtitle` replaces it. Without a description, that line is left out.

## Look at the result

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
bach preview
bach preview --theme dark --lang de
bach preview --style aurora
bach preview --uninstall
```

## Next steps

> [card] [Choices and components](/docs/guides/choices-and-components.md)
>
> Decide what the user can tick.

> [card] [The installer window](/docs/concepts/installer-window.md)
>
> Every page and state of the window.


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