# [`copy_map`](/runtime/docs/config/copy-map/)

Copy-maps let you explicitly map build inputs into your app bundle. They are referenced from `oro.toml`:

```toml
[build]
copy_map = "copy-map.toml"
```

A copy-map file can be TOML or INI. It must contain only top-level key/value pairs:

- **key**: source path (relative to the copy-map file’s directory, unless absolute)
- **value**: destination path inside the bundle (relative to the bundle resource root)

## Minimal example

```toml
"./src/index.html" = "index.html"
"./src/main.js" = "main.js"
"./src/styles.css" = "styles.css"
```

If the destination value is empty, the source is copied into the resource root (advanced; typically avoid this and spell
out the destination).

## Conditional entries (platform + build mode)

Copy-map keys may be prefixed to include entries only on certain platforms or modes:

- `win_...`, `mac_...`, `ios_...`, `linux_...`, `android_...`
- `debug_...`
- `prod_...` / `production_...`

Example:

```toml
"./src/index.html" = "index.html"

"debug_./src/dev-tools.js" = "dev-tools.js"
"prod_./src/dev-tools.js" = ""

"mac_./icons/app.icns" = "icon.icns"
"win_./icons/app.ico" = "icon.ico"
```

## Common pitfalls

- The build warns when a copy-map entry source path doesn’t exist.
- Copy-map TOML must be a single table (no nested tables).
- Prefer paths relative to your project; avoid `..` in build inputs.