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

# [app]: name, version, publisher and program

> Reference for the [app] section of bach.toml: name, version, publisher, executable, id, description, website and icon, with defaults and rules.

The `[app]` section tells Bach what the app is: its name, version, publisher and the program to start. It is required.

```toml bach.toml theme={"theme":{"light":"github-light","dark":"github-dark"}}
[app]
name = "Hello"
version = "1.4.0"
publisher = "Hello Inc."
executable = "hello.exe"
description = "Says hello, nicely."
website = "https://hello.example"
icon = "assets/hello.ico"
```

| Setting | Required | Meaning |
| - | - | - |
| `name` | yes | The app's name, as people see it: the window, the Start menu, the desktop shortcut and Settings › Apps. |
| `version` | yes | Any version text, like `1.2.0` or `2.0.0-beta.1`. Shown in the window and Settings › Apps. The first numbers also go into the setup file's details. |
| `publisher` | yes | You or your company. Shown in the window's footer and Settings › Apps. |
| `executable` | yes | The program to start, relative to `[files] source`, for example `my-app.exe` or `bin/my-app.exe`. Shortcuts and the "Open" button start it. |
| `id` | no | Identifies the install across versions (the registry key name). Defaults to `name`. Letters, digits, spaces, `.`, `-` and `_`. |
| `description` | no | One line. The shortcut's tooltip, and the line under "Install My App" on the first page (unless `[text] install_subtitle` replaces it). Without it, that line is left out. |
| `website` | no | An `https://` link, shown as the support link in Settings › Apps. |
| `icon` | no | A `.ico` file. It becomes the setup file's icon and the window's icon. When it 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. |

> [!WARNING]
>
> Never change `id` after your first release. It is how an update recognises the existing install. Change it, and updates install side by side.

## Notes

* `executable` is relative to `[files] source`, not to `bach.toml`. Bach reports a missing file in one sentence naming `app.executable`.
* `app.executable` cannot be part of an optional [component](/docs/reference/config/components.md).
* On macOS and Linux, `bach build` cannot apply `app.icon` to the setup file. Build on Windows to apply it.
* The registry entry for the install lives at `HKCU\Software\Microsoft\Windows\CurrentVersion\Uninstall\<id>`.

## Related

> [card] [\[files\]](/docs/reference/config/files)
>
> The folder that holds the program.

> [card] [Customize the window](/docs/guides/customize-the-window.md)
>
> How icon, logo and description show up.


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