modeling-app/docs/kcl/settings/user.md

---
title: "User Settings"
excerpt: "User specific settings for the app. These live in `user.toml` in the app's configuration directory. Updating the settings 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."
layout: manual
---

# User Settings

User specific settings for the app. These live in `user.toml` in the app's configuration directory. Updating the settings 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.

## User Configuration Structure

```toml
[settings.app]
# Set the appearance of the application
[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 millimeters as the default measurement unit
base_unit = "mm"

[settings.text_editor]
# Disable text wrapping in the editor
text_wrapping = false

```

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

##### project_directory

Backwards compatible project directory setting.


**Default:** None

##### theme

Backwards compatible theme setting.


**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


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

##### camera_projection

The projection mode the camera should use while modeling.


**Default:** None

##### camera_orbit

The methodology the camera should use to orbit around the model.


**Default:** None

##### mouse_controls

The controls for how to navigate the 3D view.

**Possible values:** `zoo`, `onshape`, `trackpad_friendly`, `solidworks`, `nx`, `creo`, `autocad`

**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

##### show_scale_grid

Whether or not to show a scale grid in the 3D modeling view


**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


#### project

Settings that affect the behavior of project management.


**Default:** None

This setting has the following nested options:

##### directory

The directory to save and load projects from.


**Default:** None

##### default_project_name

The default project name to use when creating a new project.


**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

```toml
[settings.app]
# Set the appearance of the application
[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 millimeters as the default measurement unit
base_unit = "mm"

[settings.text_editor]
# Disable text wrapping in the editor
text_wrapping = false

```