kcl → settings

Project Settings

Project Settings

Project specific settings for the app. These live in project.toml in the base of the project directory. Updating the settings for the project in the app will update this file automatically. Do not edit this file manually, as it may be overwritten by the app. Manual edits can cause corruption of the settings file.

Project Configuration Structure

[settings.app]
# Set the appearance of the application
name = "My Awesome Project"

[settings.app.appearance]
# Use dark mode theme
theme = "dark" 
# Set the app color to blue (240.0 = blue, 0.0 = red, 120.0 = green)
color = 240.0

[settings.modeling]
# Use inches as the default measurement unit
base_unit = "in"

Available Settings

settings

app

The settings for the modeling app.

Default: None

This setting has the following nested options:

appearance

The settings for the appearance of the app.

Default: None

This setting has further nested options. See the schema for full details.

onboarding_status

The onboarding status of the app.

Default: None

theme_color

The hue of the primary theme color for the app.

Default: None

enable_ssao

Whether or not Screen Space Ambient Occlusion (SSAO) is enabled.

Default: None

dismiss_web_banner

Permanently dismiss the banner warning to download the desktop app. This setting only applies to the web app. And is temporary until we have Linux support.

Default: None

stream_idle_mode

When the user is idle, and this is true, the stream will be torn down.

Default: None

allow_orbit_in_sketch_mode

When the user is idle, and this is true, the stream will be torn down.

Default: None

show_debug_panel

Whether to show the debug panel, which lets you see various states of the app to aid in development.

Default: None

named_views

Settings that affect the behavior of the command bar.

Default: None

modeling

Settings that affect the behavior while modeling.

Default: None

This setting has the following nested options:

base_unit

The default unit to use in modeling dimensions.

Default: None

highlight_edges

Highlight edges of 3D objects?

Default: None

show_debug_panel

Whether to show the debug panel, which lets you see various states of the app to aid in development. Remove this when we remove backwards compatibility with the old settings file.

Default: None

enable_ssao

Whether or not Screen Space Ambient Occlusion (SSAO) is enabled.

Default: None

text_editor

Settings that affect the behavior of the KCL text editor.

Default: None

This setting has the following nested options:

text_wrapping

Whether to wrap text in the editor or overflow with scroll.

Default: None

blinking_cursor

Whether to make the cursor blink in the editor.

Default: None

command_bar

Settings that affect the behavior of the command bar.

Default: None

This setting has the following nested options:

include_settings

Whether to include settings in the command bar.

Default: None

Complete Example

[settings.app]
# Set the appearance of the application
name = "My Awesome Project"

[settings.app.appearance]
# Use dark mode theme
theme = "dark" 
# Set the app color to blue (240.0 = blue, 0.0 = red, 120.0 = green)
color = 240.0

[settings.modeling]
# Use inches as the default measurement unit
base_unit = "in"