Guides / Configure your runtime project

Configure your runtime project

Keep shared settings in oro.toml and local preferences in .ororc. For Field Notes, everyone builds the same files; your machine can write artifacts to a different directory.

Choose the shared files#

In oro.toml, use a copy map to select the bundle contents:

[build]
name = "field-notes"
copy_map = "copy-map.toml"
output = "build"

Keep the existing [meta] and other sections. Project layout creates the two-file map used here.

Override the local output#

Create .ororc beside oro.toml:

[settings.build]
output = "build-local"

Ignore .ororc and build-local/ in version control. The settings. prefix selects project settings to override.

oroc print-build-dir .

Expect a path under build-local. Removing the override should restore build. Formatted config dumps can omit RC overrides, so check the command that uses the setting.

Change another setting#

Use the configuration reference for window defaults, permissions, and environment forwarding. Configuration precedence explains the full lookup order; build and package covers target-specific flags.

Source repository · Edit this page · View Markdown

Quick links

Type to search across the site. Use the up and down arrow keys to choose a result, Enter to open it, and Escape to close.