configuring_zed.md

   1# Configuring Zed
   2
   3## Folder-specific settings
   4
   5Folder-specific settings are used to override Zed's global settings for files within a specific directory in the project panel. To get started, create a `.zed` subdirectory and add a `settings.json` within it. It should be noted that folder-specific settings don't need to live only a project's root, but can be defined at multiple levels in the project hierarchy. In setups like this, Zed will find the configuration nearest to the file you are working in and apply those settings to it. In most cases, this level of flexibility won't be needed and a single configuration for all files in a project is all that is required; the `Zed > Settings > Open Local Settings` menu action is built for this case. Running this action will look for a `.zed/settings.json` file at the root of the first top-level directory in your project panel. If it does not exist, it will create it.
   6
   7The following global settings can be overridden with a folder-specific configuration:
   8
   9- `copilot`
  10- `enable_language_server`
  11- `ensure_final_newline_on_save`
  12- `format_on_save`
  13- `formatter`
  14- `hard_tabs`
  15- `language_overrides`
  16- `preferred_line_length`
  17- `remove_trailing_whitespace_on_save`
  18- `soft_wrap`
  19- `tab_size`
  20- `show_copilot_suggestions`
  21- `show_whitespaces`
  22
  23_See the Global settings section for details about these settings_
  24
  25## Global settings
  26
  27To get started with editing Zed's global settings, open `~/.config/zed/settings.json` via `⌘` + `,`, the command palette (`zed: open settings`), or the `Zed > Settings > Open Settings` application menu item.
  28
  29Here are all the currently available settings.
  30
  31## Active Pane Magnification
  32
  33- Description: Scale by which to zoom the active pane. When set to `1.0`, the active pane has the same size as others, but when set to a larger value, the active pane takes up more space.
  34- Setting: `active_pane_magnification`
  35- Default: `1.0`
  36
  37**Options**
  38
  39`float` values
  40
  41## Autosave
  42
  43- Description: When to automatically save edited buffers.
  44- Setting: `autosave`
  45- Default: `off`
  46
  47**Options**
  48
  491. To disable autosave, set it to `off`
  50
  51```json
  52{
  53  "autosave": "off"
  54}
  55```
  56
  572. To autosave when focus changes, use `on_focus_change`:
  58
  59```json
  60{
  61  "autosave": "on_focus_change"
  62}
  63```
  64
  653. To autosave when the active window changes, use `on_window_change`:
  66
  67```json
  68{
  69  "autosave": "on_window_change"
  70}
  71```
  72
  734. To autosave after an inactivity period, use `after_delay`:
  74
  75```json
  76{
  77  "autosave": {
  78    "after_delay": {
  79      "milliseconds": 1000
  80    }
  81  }
  82}
  83```
  84
  85## Auto Update
  86
  87- Description: Whether or not to automatically check for updates.
  88- Setting: `auto_update`
  89- Default: `true`
  90
  91**Options**
  92
  93`boolean` values
  94
  95## Buffer Font Family
  96
  97- Description: The name of a font to use for rendering text in the editor.
  98- Setting: `buffer_font_family`
  99- Default: `Zed Mono`
 100
 101**Options**
 102
 103The name of any font family installed on the user's system
 104
 105## Buffer Font Features
 106
 107- Description: The OpenType features to enable for text in the editor.
 108- Setting: `buffer_font_features`
 109- Default: `null`
 110
 111**Options**
 112
 113Zed supports a subset of OpenType features that can be enabled or disabled for a given buffer or terminal font. The following [OpenType features](https://en.wikipedia.org/wiki/List_of_typographic_features) can be enabled or disabled too: `calt`, `case`, `cpsp`, `frac`, `liga`, `onum`, `ordn`, `pnum`, `ss01`, `ss02`, `ss03`, `ss04`, `ss05`, `ss06`, `ss07`, `ss08`, `ss09`, `ss10`, `ss11`, `ss12`, `ss13`, `ss14`, `ss15`, `ss16`, `ss17`, `ss18`, `ss19`, `ss20`, `subs`, `sups`, `swsh`, `titl`, `tnum`, `zero`.
 114
 115For example, to disable ligatures for a given font you can add the following to your settings:
 116
 117```json
 118{
 119  "buffer_font_features": {
 120    "calt": false
 121  }
 122}
 123```
 124
 125## Buffer Font Size
 126
 127- Description: The default font size for text in the editor.
 128- Setting: `buffer_font_size`
 129- Default: `15`
 130
 131**Options**
 132
 133`integer` values
 134
 135## Confirm Quit
 136
 137- Description: Whether or not to prompt the user to confirm before closing the application.
 138- Setting: `confirm_quit`
 139- Default: `false`
 140
 141**Options**
 142
 143`boolean` values
 144
 145## Copilot
 146
 147- Description: Copilot-specific settings.
 148- Setting: `copilot`
 149- Default:
 150
 151```json
 152"copilot": {
 153  "disabled_globs": [
 154    ".env"
 155  ]
 156}
 157```
 158
 159**Options**
 160
 161### Disabled Globs
 162
 163- Description: The set of glob patterns for which Copilot should be disabled in any matching file.
 164- Setting: `disabled_globs`
 165- Default: [".env"]
 166
 167**Options**
 168
 169List of `string` values
 170
 171## Cursor Blink
 172
 173- Description: Whether or not the cursor blinks.
 174- Setting: `cursor_blink`
 175- Default: `true`
 176
 177**Options**
 178
 179`boolean` values
 180
 181## Default Dock Anchor
 182
 183- Description: The default anchor for new docks.
 184- Setting: `default_dock_anchor`
 185- Default: `bottom`
 186
 187**Options**
 188
 1891. Position the dock attached to the bottom of the workspace: `bottom`
 1902. Position the dock to the right of the workspace like a side panel: `right`
 1913. Position the dock full screen over the entire workspace: `expanded`
 192
 193## Editor Toolbar
 194
 195- Description: Whether or not to show various elements in the editor toolbar.
 196- Setting: `toolbar`
 197- Default:
 198
 199```json
 200"toolbar": {
 201  "breadcrumbs": true,
 202  "quick_actions": true
 203},
 204```
 205
 206**Options**
 207
 208Each option controls displaying of a particular toolbar element. If all elements are hidden, the editor toolbar is not displayed.
 209
 210## Enable Language Server
 211
 212- Description: Whether or not to use language servers to provide code intelligence.
 213- Setting: `enable_language_server`
 214- Default: `true`
 215
 216**Options**
 217
 218`boolean` values
 219
 220## Ensure Final Newline On Save
 221
 222- Description: Whether or not to ensure there's a single newline at the end of a buffer when saving it.
 223- Setting: `ensure_final_newline_on_save`
 224- Default: `true`
 225
 226**Options**
 227
 228`boolean` values
 229
 230## LSP
 231
 232- Description: Configuration for language servers.
 233- Setting: `lsp`
 234- Default: `null`
 235
 236**Options**
 237
 238The following settings can be overridden for specific language servers:
 239
 240- `initialization_options`
 241
 242To override settings for a language, add an entry for that language server's name to the `lsp` value. Example:
 243
 244```json
 245"lsp": {
 246  "rust-analyzer": {
 247    "initialization_options": {
 248      "check": {
 249        "command": "clippy" // rust-analyzer.check.command (default: "check")
 250      }
 251    }
 252  }
 253}
 254```
 255
 256## Format On Save
 257
 258- Description: Whether or not to perform a buffer format before saving.
 259- Setting: `format_on_save`
 260- Default: `on`
 261
 262**Options**
 263
 2641. `on`, enables format on save obeying `formatter` setting:
 265
 266```json
 267{
 268  "format_on_save": "on"
 269}
 270```
 271
 2722. `off`, disables format on save:
 273
 274```json
 275{
 276  "format_on_save": "off"
 277}
 278```
 279
 280## Formatter
 281
 282- Description: How to perform a buffer format.
 283- Setting: `formatter`
 284- Default: `language_server`
 285
 286**Options**
 287
 2881. To use the current language server, use `"language_server"`:
 289
 290```json
 291{
 292  "formatter": "language_server"
 293}
 294```
 295
 2962. Or to use an external command, use `"external"`. Specify the name of the formatting program to run, and an array of arguments to pass to the program. The buffer's text will be passed to the program on stdin, and the formatted output should be written to stdout. For example, the following command would strip trailing spaces using [`sed(1)`](https://linux.die.net/man/1/sed):
 297
 298```json
 299{
 300  "formatter": {
 301    "external": {
 302      "command": "sed",
 303      "arguments": ["-e", "s/ *$//"]
 304    }
 305  }
 306}
 307```
 308
 309## Code Actions On Format
 310
 311- Description: The code actions to perform with the primary language server when formatting the buffer.
 312- Setting: `code_actions_on_format`
 313- Default: `{}`, except for Go it's `{ "source.organizeImports": true }`
 314
 315**Examples**
 316
 3171. Organize imports on format in TypeScript and TSX buffers:
 318
 319```json
 320{
 321  "languages": {
 322    "TypeScript": {
 323      "code_actions_on_format": {
 324        "source.organizeImports": true
 325      }
 326    },
 327    "TSX": {
 328      "code_actions_on_format": {
 329        "source.organizeImports": true
 330      }
 331    }
 332  }
 333}
 334```
 335
 3362. Run ESLint `fixAll` code action when formatting (requires Zed `0.125.0`):
 337
 338```json
 339{
 340  "languages": {
 341    "JavaScript": {
 342      "code_actions_on_format": {
 343        "source.fixAll.eslint": true
 344      }
 345    }
 346  }
 347}
 348```
 349
 3503. Run only a single ESLint rule when using `fixAll` (requires Zed `0.125.0`):
 351
 352```json
 353{
 354  "languages": {
 355    "JavaScript": {
 356      "code_actions_on_format": {
 357        "source.fixAll.eslint": true
 358      }
 359    }
 360  },
 361  "lsp": {
 362    "eslint": {
 363      "settings": {
 364        "codeActionOnSave": {
 365          "rules": ["import/order"]
 366        }
 367      }
 368    }
 369  }
 370}
 371```
 372
 373## Auto close
 374
 375- Description: Whether or not to automatically type closing characters for you.
 376- Setting: `use_autoclose`
 377- Default: `true`
 378
 379**Options**
 380
 381`boolean` values
 382
 383## Git
 384
 385- Description: Configuration for git-related features.
 386- Setting: `git`
 387- Default:
 388
 389```json
 390"git": {
 391  "git_gutter": "tracked_files"
 392},
 393```
 394
 395### Git Gutter
 396
 397- Description: Whether or not to show the git gutter.
 398- Setting: `git_gutter`
 399- Default: `tracked_files`
 400
 401**Options**
 402
 4031. Show git gutter in tracked files
 404
 405```json
 406{
 407  "git_gutter": "tracked_files"
 408}
 409```
 410
 4112. Hide git gutter
 412
 413```json
 414{
 415  "git_gutter": "hide"
 416}
 417```
 418
 419## Hard Tabs
 420
 421- Description: Whether to indent lines using tab characters or multiple spaces.
 422- Setting: `hard_tabs`
 423- Default: `false`
 424
 425**Options**
 426
 427`boolean` values
 428
 429## Hover Popover Enabled
 430
 431- Description: Whether or not to show the informational hover box when moving the mouse over symbols in the editor.
 432- Setting: `hover_popover_enabled`
 433- Default: `true`
 434
 435**Options**
 436
 437`boolean` values
 438
 439## Inlay hints
 440
 441- Description: Configuration for displaying extra text with hints in the editor.
 442- Setting: `inlay_hints`
 443- Default:
 444
 445```json
 446"inlay_hints": {
 447  "enabled": false,
 448  "show_type_hints": true,
 449  "show_parameter_hints": true,
 450  "show_other_hints": true,
 451  "edit_debounce_ms": 700,
 452  "scroll_debounce_ms": 50
 453}
 454```
 455
 456**Options**
 457
 458Inlay hints querying consists of two parts: editor (client) and LSP server.
 459With the inlay settings above are changed to enable the hints, editor will start to query certain types of hints and react on LSP hint refresh request from the server.
 460At this point, the server may or may not return hints depending on its implementation, further configuration might be needed, refer to the corresponding LSP server documentation.
 461
 462The following languages have inlay hints preconfigured by Zed:
 463
 464- [Go](https://docs.zed.dev/languages/go)
 465- [Rust](https://docs.zed.dev/languages/rust)
 466- [Svelte](https://docs.zed.dev/languages/svelte)
 467- [Typescript](https://docs.zed.dev/languages/typescript)
 468
 469Use the `lsp` section for the server configuration. Examples are provided in the corresponding language documentation.
 470
 471Hints are not instantly queried in Zed, two kinds of debounces are used, either may be set to 0 to be disabled.
 472Settings-related hint updates are not debounced.
 473
 474## Journal
 475
 476- Description: Configuration for the journal.
 477- Setting: `journal`
 478- Default:
 479
 480```json
 481"journal": {
 482  "path": "~",
 483  "hour_format": "hour12"
 484}
 485```
 486
 487### Path
 488
 489- Description: The path of the directory where journal entries are stored.
 490- Setting: `path`
 491- Default: `~`
 492
 493**Options**
 494
 495`string` values
 496
 497### Hour Format
 498
 499- Description: The format to use for displaying hours in the journal.
 500- Setting: `hour_format`
 501- Default: `hour12`
 502
 503**Options**
 504
 5051. 12-hour format:
 506
 507```json
 508{
 509  "hour_format": "hour12"
 510}
 511```
 512
 5132. 24-hour format:
 514
 515```json
 516{
 517  "hour_format": "hour24"
 518}
 519```
 520
 521## Language Overrides
 522
 523- Description: Configuration overrides for specific languages.
 524- Setting: `language_overrides`
 525- Default: `null`
 526
 527**Options**
 528
 529To override settings for a language, add an entry for that languages name to the `language_overrides` value. Example:
 530
 531```json
 532"language_overrides": {
 533  "C": {
 534    "format_on_save": "off",
 535    "preferred_line_length": 64,
 536    "soft_wrap": "preferred_line_length"
 537  },
 538  "JSON": {
 539    "tab_size": 4
 540  }
 541}
 542```
 543
 544The following settings can be overridden for each specific language:
 545
 546- `enable_language_server`
 547- `ensure_final_newline_on_save`
 548- `format_on_save`
 549- `formatter`
 550- `hard_tabs`
 551- `preferred_line_length`
 552- `remove_trailing_whitespace_on_save`
 553- `show_copilot_suggestions`
 554- `show_whitespaces`
 555- `soft_wrap`
 556- `tab_size`
 557
 558These values take in the same options as the root-level settings with the same name.
 559
 560## Preferred Line Length
 561
 562- Description: The column at which to soft-wrap lines, for buffers where soft-wrap is enabled.
 563- Setting: `preferred_line_length`
 564- Default: `80`
 565
 566**Options**
 567
 568`integer` values
 569
 570## Projects Online By Default
 571
 572- Description: Whether or not to show the online projects view by default.
 573- Setting: `projects_online_by_default`
 574- Default: `true`
 575
 576**Options**
 577
 578`boolean` values
 579
 580## Remove Trailing Whitespace On Save
 581
 582- Description: Whether or not to remove any trailing whitespace from lines of a buffer before saving it.
 583- Setting: `remove_trailing_whitespace_on_save`
 584- Default: `true`
 585
 586**Options**
 587
 588`boolean` values
 589
 590## Semantic Index
 591
 592- Description: Settings related to semantic index.
 593- Setting: `semantic_index`
 594- Default:
 595
 596```json
 597"semantic_index": {
 598  "enabled": false
 599},
 600```
 601
 602### Enabled
 603
 604- Description: Whether or not to display the `Semantic` mode in project search.
 605- Setting: `enabled`
 606- Default: `true`
 607
 608**Options**
 609
 610`boolean` values
 611
 612## Show Call Status Icon
 613
 614- Description: Whether or not to show the call status icon in the status bar.
 615- Setting: `show_call_status_icon`
 616- Default: `true`
 617
 618**Options**
 619
 620`boolean` values
 621
 622## Show Completions On Input
 623
 624- Description: Whether or not to show completions as you type.
 625- Setting: `show_completions_on_input`
 626- Default: `true`
 627
 628**Options**
 629
 630`boolean` values
 631
 632## Show Completion Documentation
 633
 634- Description: Whether to display inline and alongside documentation for items in the completions menu.
 635- Setting: `show_completion_documentation`
 636- Default: `true`
 637
 638**Options**
 639
 640`boolean` values
 641
 642## Completion Documentation Debounce Delay
 643
 644- Description: The debounce delay before re-querying the language server for completion documentation when not included in original completion list.
 645- Setting: `completion_documentation_secondary_query_debounce`
 646- Default: `300` ms
 647
 648**Options**
 649
 650`integer` values
 651
 652## Show Copilot Suggestions
 653
 654- Description: Whether or not to show Copilot suggestions as you type or wait for a `copilot::Toggle`.
 655- Setting: `show_copilot_suggestions`
 656- Default: `true`
 657
 658**Options**
 659
 660`boolean` values
 661
 662## Show Whitespaces
 663
 664- Description: Whether or not to show render whitespace characters in the editor.
 665- Setting: `show_whitespaces`
 666- Default: `selection`
 667
 668**Options**
 669
 6701. `all`
 6712. `selection`
 6723. `none`
 673
 674## Soft Wrap
 675
 676- Description: Whether or not to automatically wrap lines of text to fit editor / preferred width.
 677- Setting: `soft_wrap`
 678- Default: `none`
 679
 680**Options**
 681
 6821. `editor_width`
 6832. `preferred_line_length`
 6843. `none`
 685
 686## Tab Size
 687
 688- Description: The number of spaces to use for each tab character.
 689- Setting: `tab_size`
 690- Default: `4`
 691
 692**Options**
 693
 694`integer` values
 695
 696## Telemetry
 697
 698- Description: Control what info is collected by Zed.
 699- Setting: `telemetry`
 700- Default:
 701
 702```json
 703"telemetry": {
 704  "diagnostics": true,
 705  "metrics": true
 706},
 707```
 708
 709**Options**
 710
 711### Diagnostics
 712
 713- Description: Setting for sending debug-related data, such as crash reports.
 714- Setting: `diagnostics`
 715- Default: `true`
 716
 717**Options**
 718
 719`boolean` values
 720
 721### Metrics
 722
 723- Description: Setting for sending anonymized usage data, such what languages you're using Zed with.
 724- Setting: `metrics`
 725- Default: `true`
 726
 727**Options**
 728
 729`boolean` values
 730
 731## Terminal
 732
 733- Description: Configuration for the terminal.
 734- Setting: `terminal`
 735- Default:
 736
 737```json
 738"terminal": {
 739  "alternate_scroll": "off",
 740  "blinking": "terminal_controlled",
 741  "copy_on_select": false,
 742  "env": {},
 743  "font_family": null,
 744  "font_features": null,
 745  "font_size": null,
 746  "option_as_meta": false,
 747  "shell": {},
 748  "toolbar": {
 749    "title": true
 750  },
 751  "working_directory": "current_project_directory"
 752}
 753```
 754
 755### Alternate Scroll
 756
 757- Description: Set whether Alternate Scroll mode (DECSET code: `?1007`) is active by default. Alternate Scroll mode converts mouse scroll events into up / down key presses when in the alternate screen (e.g. when running applications like vim or less). The terminal can still set and unset this mode with ANSI escape codes.
 758- Setting: `alternate_scroll`
 759- Default: `off`
 760
 761**Options**
 762
 7631. Default alternate scroll mode to on
 764
 765```json
 766{
 767  "alternate_scroll": "on"
 768}
 769```
 770
 7712. Default alternate scroll mode to off
 772
 773```json
 774{
 775  "alternate_scroll": "off"
 776}
 777```
 778
 779### Blinking
 780
 781- Description: Set the cursor blinking behavior in the terminal
 782- Setting: `blinking`
 783- Default: `terminal_controlled`
 784
 785**Options**
 786
 7871. Never blink the cursor, ignore the terminal mode
 788
 789```json
 790{
 791  "blinking": "off"
 792}
 793```
 794
 7952. Default the cursor blink to off, but allow the terminal to turn blinking on
 796
 797```json
 798{
 799  "blinking": "terminal_controlled"
 800}
 801```
 802
 8033. Always blink the cursor, ignore the terminal mode
 804
 805```json
 806"blinking": "on",
 807```
 808
 809### Copy On Select
 810
 811- Description: Whether or not selecting text in the terminal will automatically copy to the system clipboard.
 812- Setting: `copy_on_select`
 813- Default: `false`
 814
 815**Options**
 816
 817`boolean` values
 818
 819### Env
 820
 821- Description: Any key-value pairs added to this object will be added to the terminal's environment. Keys must be unique, use `:` to separate multiple values in a single variable
 822- Setting: `env`
 823- Default: `{}`
 824
 825**Example**
 826
 827```json
 828"env": {
 829  "ZED": "1",
 830  "KEY": "value1:value2"
 831}
 832```
 833
 834### Font Size
 835
 836- Description: What font size to use for the terminal. When not set defaults to matching the editor's font size
 837- Setting: `font_size`
 838- Default: `null`
 839
 840**Options**
 841
 842`integer` values
 843
 844### Font Family
 845
 846- Description: What font to use for the terminal. When not set, defaults to matching the editor's font.
 847- Setting: `font_family`
 848- Default: `null`
 849
 850**Options**
 851
 852The name of any font family installed on the user's system
 853
 854### Font Features
 855
 856- Description: What font features to use for the terminal. When not set, defaults to matching the editor's font features.
 857- Setting: `font_features`
 858- Default: `null`
 859
 860**Options**
 861
 862See Buffer Font Features
 863
 864### Option As Meta
 865
 866- Description: Re-interprets the option keys to act like a 'meta' key, like in Emacs.
 867- Setting: `option_as_meta`
 868- Default: `true`
 869
 870**Options**
 871
 872`boolean` values
 873
 874### Shell
 875
 876- Description: What shell to use when launching the terminal.
 877- Setting: `shell`
 878- Default: `system`
 879
 880**Options**
 881
 8821. Use the system's default terminal configuration (usually the `/etc/passwd` file).
 883
 884```json
 885{
 886  "shell": "system"
 887}
 888```
 889
 8902. A program to launch:
 891
 892```json
 893"shell": {
 894    "program": "sh"
 895}
 896```
 897
 8983. A program with arguments:
 899
 900```json
 901"shell": {
 902  "with_arguments": {
 903    "program": "/bin/bash",
 904    "args": ["--login"]
 905  }
 906}
 907```
 908
 909## Terminal Toolbar
 910
 911- Description: Whether or not to show various elements in the terminal toolbar. It only affects terminals placed in the editor pane.
 912- Setting: `toolbar`
 913- Default:
 914
 915```json
 916"toolbar": {
 917  "title": true,
 918},
 919```
 920
 921**Options**
 922
 923At the moment, only the `title` option is available, it controls displaying of the terminal title that can be changed via `PROMPT_COMMAND`. If the title is hidden, the terminal toolbar is not displayed.
 924
 925### Working Directory
 926
 927- Description: What working directory to use when launching the terminal.
 928- Setting: `working_directory`
 929- Default: `"current_project_directory"`
 930
 931**Options**
 932
 9331. Use the current file's project directory. Will Fallback to the first project directory strategy if unsuccessful
 934
 935```json
 936{
 937  "working_directory": "current_project_directory"
 938}
 939```
 940
 9412. Use the first project in this workspace's directory. Will fallback to using this platform's home directory.
 942
 943```json
 944{
 945  "working_directory": "first_project_directory"
 946}
 947```
 948
 9493. Always use this platform's home directory (if we can find it)
 950
 951```json
 952{
 953  "working_directory": "always_home"
 954}
 955```
 956
 9574. Always use a specific directory. This value will be shell expanded. If this path is not a valid directory the terminal will default to this platform's home directory.
 958
 959```json
 960"working_directory": {
 961  "always": {
 962    "directory": "~/zed/projects/"
 963  }
 964}
 965```
 966
 967## Theme
 968
 969- Description: The theme setting can be specified in two forms - either as the name of a theme or as an object containing the `mode`, `dark`, and `light` themes for the Zed UI.
 970- Setting: `theme`
 971- Default: `One Dark`
 972
 973### Theme Object
 974
 975- Description: Specify the theme using an object that includes the `mode`, `dark`, and `light` themes.
 976- Setting: `theme`
 977- Default:
 978
 979```json
 980"theme": {
 981  "mode": "dark",
 982  "dark": "One Dark",
 983  "light": "One Light"
 984},
 985```
 986
 987### Mode
 988
 989- Description: Specify theme mode.
 990- Setting: `mode`
 991- Default: `dark`
 992
 993**Options**
 994
 9951. Set the theme to dark mode
 996
 997```json
 998{
 999  "mode": "dark"
1000}
1001```
1002
10032. Set the theme to light mode
1004
1005```json
1006{
1007  "mode": "light"
1008}
1009```
1010
10113. Set the theme to system mode
1012
1013```json
1014{
1015  "mode": "system"
1016}
1017```
1018
1019### Dark
1020
1021- Description: The name of the dark Zed theme to use for the UI.
1022- Setting: `dark`
1023- Default: `One Dark`
1024
1025**Options**
1026
1027Run the `theme selector: toggle` action in the command palette to see a current list of valid themes names.
1028
1029### Light
1030
1031- Description: The name of the light Zed theme to use for the UI.
1032- Setting: `light`
1033- Default: `One Light`
1034
1035**Options**
1036
1037Run the `theme selector: toggle` action in the command palette to see a current list of valid themes names.
1038
1039## Vim
1040
1041- Description: Whether or not to enable vim mode (work in progress).
1042- Setting: `vim_mode`
1043- Default: `false`
1044
1045## Project Panel
1046
1047- Description: Customise project panel
1048- Setting: `project_panel`
1049- Default:
1050
1051```json
1052"project_panel": {
1053  "dock": "left",
1054  "git_status": true,
1055  "default_width": "N/A - width in pixels"
1056},
1057```
1058
1059### Dock
1060
1061- Description: Control the position of the dock
1062- Setting: `dock`
1063- Default: `left`
1064
1065**Options**
1066
10671. Default dock position to left
1068
1069```json
1070{
1071  "dock": "left"
1072}
1073```
1074
10752. Default dock position to right
1076
1077```json
1078{
1079  "dock": "right"
1080}
1081```
1082
1083### Git Status
1084
1085- Description: Indicates newly created and updated files
1086- Setting: `git_status`
1087- Default: `true`
1088
10891. Default enable git status
1090
1091```json
1092{
1093  "git_status": true
1094}
1095```
1096
10972. Default disable git status
1098
1099```json
1100{
1101  "git_status": false
1102}
1103```
1104
1105### Default Width
1106
1107- Description: Customise default width taken by project panel
1108- Setting: `default_width`
1109- Default: N/A width in pixels (eg: 420)
1110
1111**Options**
1112
1113`boolean` values
1114
1115## An example configuration:
1116
1117```json
1118// ~/.config/zed/settings.json
1119{
1120  "theme": "cave-light",
1121  "tab_size": 2,
1122  "preferred_line_length": 80,
1123  "soft_wrap": "none",
1124
1125  "buffer_font_size": 18,
1126  "buffer_font_family": "Zed Mono",
1127
1128  "autosave": "on_focus_change",
1129  "format_on_save": "off",
1130  "vim_mode": false,
1131  "projects_online_by_default": true,
1132  "terminal": {
1133    "font_family": "FiraCode Nerd Font Mono",
1134    "blinking": "off"
1135  },
1136  "language_overrides": {
1137    "C": {
1138      "format_on_save": "language_server",
1139      "preferred_line_length": 64,
1140      "soft_wrap": "preferred_line_length"
1141    }
1142  }
1143}
1144```