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## Always Treat Brackets As Autoclosed
 384
 385- Description: Controls how the editor handles the autoclosed characters.
 386- Setting: `always_treat_brackets_as_autoclosed`
 387- Default: `false`
 388
 389**Options**
 390
 391`boolean` values
 392
 393**Example**
 394
 395If the setting is set to `true`:
 396
 3971. Enter in the editor: `)))`
 3982. Move the cursor to the start: `^)))`
 3993. Enter again: `)))`
 400
 401The result is still `)))` and not `))))))`, which is what it would be by default.
 402
 403## File Types
 404
 405- Setting: `file_types`
 406- Description: Configure how Zed selects a language for a file based on its filename or extension.
 407- Default: `{}`
 408
 409**Examples**
 410
 411To interpret all `.c` files as C++, and files called `MyLockFile` as TOML:
 412
 413```json
 414{
 415  "file_types": {
 416    "C++": ["c"],
 417    "TOML": ["MyLockFile"]
 418  }
 419}
 420```
 421
 422## Git
 423
 424- Description: Configuration for git-related features.
 425- Setting: `git`
 426- Default:
 427
 428```json
 429"git": {
 430  "git_gutter": "tracked_files"
 431},
 432```
 433
 434### Git Gutter
 435
 436- Description: Whether or not to show the git gutter.
 437- Setting: `git_gutter`
 438- Default: `tracked_files`
 439
 440**Options**
 441
 4421. Show git gutter in tracked files
 443
 444```json
 445{
 446  "git_gutter": "tracked_files"
 447}
 448```
 449
 4502. Hide git gutter
 451
 452```json
 453{
 454  "git_gutter": "hide"
 455}
 456```
 457
 458## Hard Tabs
 459
 460- Description: Whether to indent lines using tab characters or multiple spaces.
 461- Setting: `hard_tabs`
 462- Default: `false`
 463
 464**Options**
 465
 466`boolean` values
 467
 468## Hover Popover Enabled
 469
 470- Description: Whether or not to show the informational hover box when moving the mouse over symbols in the editor.
 471- Setting: `hover_popover_enabled`
 472- Default: `true`
 473
 474**Options**
 475
 476`boolean` values
 477
 478## Inlay hints
 479
 480- Description: Configuration for displaying extra text with hints in the editor.
 481- Setting: `inlay_hints`
 482- Default:
 483
 484```json
 485"inlay_hints": {
 486  "enabled": false,
 487  "show_type_hints": true,
 488  "show_parameter_hints": true,
 489  "show_other_hints": true,
 490  "edit_debounce_ms": 700,
 491  "scroll_debounce_ms": 50
 492}
 493```
 494
 495**Options**
 496
 497Inlay hints querying consists of two parts: editor (client) and LSP server.
 498With 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.
 499At 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.
 500
 501The following languages have inlay hints preconfigured by Zed:
 502
 503- [Go](https://docs.zed.dev/languages/go)
 504- [Rust](https://docs.zed.dev/languages/rust)
 505- [Svelte](https://docs.zed.dev/languages/svelte)
 506- [Typescript](https://docs.zed.dev/languages/typescript)
 507
 508Use the `lsp` section for the server configuration. Examples are provided in the corresponding language documentation.
 509
 510Hints are not instantly queried in Zed, two kinds of debounces are used, either may be set to 0 to be disabled.
 511Settings-related hint updates are not debounced.
 512
 513## Journal
 514
 515- Description: Configuration for the journal.
 516- Setting: `journal`
 517- Default:
 518
 519```json
 520"journal": {
 521  "path": "~",
 522  "hour_format": "hour12"
 523}
 524```
 525
 526### Path
 527
 528- Description: The path of the directory where journal entries are stored.
 529- Setting: `path`
 530- Default: `~`
 531
 532**Options**
 533
 534`string` values
 535
 536### Hour Format
 537
 538- Description: The format to use for displaying hours in the journal.
 539- Setting: `hour_format`
 540- Default: `hour12`
 541
 542**Options**
 543
 5441. 12-hour format:
 545
 546```json
 547{
 548  "hour_format": "hour12"
 549}
 550```
 551
 5522. 24-hour format:
 553
 554```json
 555{
 556  "hour_format": "hour24"
 557}
 558```
 559
 560## Language Overrides
 561
 562- Description: Configuration overrides for specific languages.
 563- Setting: `language_overrides`
 564- Default: `null`
 565
 566**Options**
 567
 568To override settings for a language, add an entry for that languages name to the `language_overrides` value. Example:
 569
 570```json
 571"language_overrides": {
 572  "C": {
 573    "format_on_save": "off",
 574    "preferred_line_length": 64,
 575    "soft_wrap": "preferred_line_length"
 576  },
 577  "JSON": {
 578    "tab_size": 4
 579  }
 580}
 581```
 582
 583The following settings can be overridden for each specific language:
 584
 585- `enable_language_server`
 586- `ensure_final_newline_on_save`
 587- `format_on_save`
 588- `formatter`
 589- `hard_tabs`
 590- `preferred_line_length`
 591- `remove_trailing_whitespace_on_save`
 592- `show_copilot_suggestions`
 593- `show_whitespaces`
 594- `soft_wrap`
 595- `tab_size`
 596- `use_autoclose`
 597- `always_treat_brackets_as_autoclosed`
 598
 599These values take in the same options as the root-level settings with the same name.
 600
 601## Preferred Line Length
 602
 603- Description: The column at which to soft-wrap lines, for buffers where soft-wrap is enabled.
 604- Setting: `preferred_line_length`
 605- Default: `80`
 606
 607**Options**
 608
 609`integer` values
 610
 611## Projects Online By Default
 612
 613- Description: Whether or not to show the online projects view by default.
 614- Setting: `projects_online_by_default`
 615- Default: `true`
 616
 617**Options**
 618
 619`boolean` values
 620
 621## Remove Trailing Whitespace On Save
 622
 623- Description: Whether or not to remove any trailing whitespace from lines of a buffer before saving it.
 624- Setting: `remove_trailing_whitespace_on_save`
 625- Default: `true`
 626
 627**Options**
 628
 629`boolean` values
 630
 631## Show Call Status Icon
 632
 633- Description: Whether or not to show the call status icon in the status bar.
 634- Setting: `show_call_status_icon`
 635- Default: `true`
 636
 637**Options**
 638
 639`boolean` values
 640
 641## Show Completions On Input
 642
 643- Description: Whether or not to show completions as you type.
 644- Setting: `show_completions_on_input`
 645- Default: `true`
 646
 647**Options**
 648
 649`boolean` values
 650
 651## Show Completion Documentation
 652
 653- Description: Whether to display inline and alongside documentation for items in the completions menu.
 654- Setting: `show_completion_documentation`
 655- Default: `true`
 656
 657**Options**
 658
 659`boolean` values
 660
 661## Completion Documentation Debounce Delay
 662
 663- Description: The debounce delay before re-querying the language server for completion documentation when not included in original completion list.
 664- Setting: `completion_documentation_secondary_query_debounce`
 665- Default: `300` ms
 666
 667**Options**
 668
 669`integer` values
 670
 671## Show Copilot Suggestions
 672
 673- Description: Whether or not to show Copilot suggestions as you type or wait for a `copilot::Toggle`.
 674- Setting: `show_copilot_suggestions`
 675- Default: `true`
 676
 677**Options**
 678
 679`boolean` values
 680
 681## Show Whitespaces
 682
 683- Description: Whether or not to show render whitespace characters in the editor.
 684- Setting: `show_whitespaces`
 685- Default: `selection`
 686
 687**Options**
 688
 6891. `all`
 6902. `selection`
 6913. `none`
 692
 693## Soft Wrap
 694
 695- Description: Whether or not to automatically wrap lines of text to fit editor / preferred width.
 696- Setting: `soft_wrap`
 697- Default: `none`
 698
 699**Options**
 700
 7011. `editor_width`
 7022. `preferred_line_length`
 7033. `none`
 704
 705## Tab Size
 706
 707- Description: The number of spaces to use for each tab character.
 708- Setting: `tab_size`
 709- Default: `4`
 710
 711**Options**
 712
 713`integer` values
 714
 715## Telemetry
 716
 717- Description: Control what info is collected by Zed.
 718- Setting: `telemetry`
 719- Default:
 720
 721```json
 722"telemetry": {
 723  "diagnostics": true,
 724  "metrics": true
 725},
 726```
 727
 728**Options**
 729
 730### Diagnostics
 731
 732- Description: Setting for sending debug-related data, such as crash reports.
 733- Setting: `diagnostics`
 734- Default: `true`
 735
 736**Options**
 737
 738`boolean` values
 739
 740### Metrics
 741
 742- Description: Setting for sending anonymized usage data, such what languages you're using Zed with.
 743- Setting: `metrics`
 744- Default: `true`
 745
 746**Options**
 747
 748`boolean` values
 749
 750## Terminal
 751
 752- Description: Configuration for the terminal.
 753- Setting: `terminal`
 754- Default:
 755
 756```json
 757"terminal": {
 758  "alternate_scroll": "off",
 759  "blinking": "terminal_controlled",
 760  "copy_on_select": false,
 761  "env": {},
 762  "font_family": null,
 763  "font_features": null,
 764  "font_size": null,
 765  "option_as_meta": false,
 766  "shell": {},
 767  "toolbar": {
 768    "title": true
 769  },
 770  "working_directory": "current_project_directory"
 771}
 772```
 773
 774### Alternate Scroll
 775
 776- 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.
 777- Setting: `alternate_scroll`
 778- Default: `off`
 779
 780**Options**
 781
 7821. Default alternate scroll mode to on
 783
 784```json
 785{
 786  "alternate_scroll": "on"
 787}
 788```
 789
 7902. Default alternate scroll mode to off
 791
 792```json
 793{
 794  "alternate_scroll": "off"
 795}
 796```
 797
 798### Blinking
 799
 800- Description: Set the cursor blinking behavior in the terminal
 801- Setting: `blinking`
 802- Default: `terminal_controlled`
 803
 804**Options**
 805
 8061. Never blink the cursor, ignore the terminal mode
 807
 808```json
 809{
 810  "blinking": "off"
 811}
 812```
 813
 8142. Default the cursor blink to off, but allow the terminal to turn blinking on
 815
 816```json
 817{
 818  "blinking": "terminal_controlled"
 819}
 820```
 821
 8223. Always blink the cursor, ignore the terminal mode
 823
 824```json
 825"blinking": "on",
 826```
 827
 828### Copy On Select
 829
 830- Description: Whether or not selecting text in the terminal will automatically copy to the system clipboard.
 831- Setting: `copy_on_select`
 832- Default: `false`
 833
 834**Options**
 835
 836`boolean` values
 837
 838### Env
 839
 840- 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
 841- Setting: `env`
 842- Default: `{}`
 843
 844**Example**
 845
 846```json
 847"env": {
 848  "ZED": "1",
 849  "KEY": "value1:value2"
 850}
 851```
 852
 853### Font Size
 854
 855- Description: What font size to use for the terminal. When not set defaults to matching the editor's font size
 856- Setting: `font_size`
 857- Default: `null`
 858
 859**Options**
 860
 861`integer` values
 862
 863### Font Family
 864
 865- Description: What font to use for the terminal. When not set, defaults to matching the editor's font.
 866- Setting: `font_family`
 867- Default: `null`
 868
 869**Options**
 870
 871The name of any font family installed on the user's system
 872
 873### Font Features
 874
 875- Description: What font features to use for the terminal. When not set, defaults to matching the editor's font features.
 876- Setting: `font_features`
 877- Default: `null`
 878
 879**Options**
 880
 881See Buffer Font Features
 882
 883### Option As Meta
 884
 885- Description: Re-interprets the option keys to act like a 'meta' key, like in Emacs.
 886- Setting: `option_as_meta`
 887- Default: `true`
 888
 889**Options**
 890
 891`boolean` values
 892
 893### Shell
 894
 895- Description: What shell to use when launching the terminal.
 896- Setting: `shell`
 897- Default: `system`
 898
 899**Options**
 900
 9011. Use the system's default terminal configuration (usually the `/etc/passwd` file).
 902
 903```json
 904{
 905  "shell": "system"
 906}
 907```
 908
 9092. A program to launch:
 910
 911```json
 912"shell": {
 913    "program": "sh"
 914}
 915```
 916
 9173. A program with arguments:
 918
 919```json
 920"shell": {
 921  "with_arguments": {
 922    "program": "/bin/bash",
 923    "args": ["--login"]
 924  }
 925}
 926```
 927
 928## Terminal Toolbar
 929
 930- Description: Whether or not to show various elements in the terminal toolbar. It only affects terminals placed in the editor pane.
 931- Setting: `toolbar`
 932- Default:
 933
 934```json
 935"toolbar": {
 936  "title": true,
 937},
 938```
 939
 940**Options**
 941
 942At 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.
 943
 944### Working Directory
 945
 946- Description: What working directory to use when launching the terminal.
 947- Setting: `working_directory`
 948- Default: `"current_project_directory"`
 949
 950**Options**
 951
 9521. Use the current file's project directory. Will Fallback to the first project directory strategy if unsuccessful
 953
 954```json
 955{
 956  "working_directory": "current_project_directory"
 957}
 958```
 959
 9602. Use the first project in this workspace's directory. Will fallback to using this platform's home directory.
 961
 962```json
 963{
 964  "working_directory": "first_project_directory"
 965}
 966```
 967
 9683. Always use this platform's home directory (if we can find it)
 969
 970```json
 971{
 972  "working_directory": "always_home"
 973}
 974```
 975
 9764. 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.
 977
 978```json
 979"working_directory": {
 980  "always": {
 981    "directory": "~/zed/projects/"
 982  }
 983}
 984```
 985
 986## Theme
 987
 988- 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.
 989- Setting: `theme`
 990- Default: `One Dark`
 991
 992### Theme Object
 993
 994- Description: Specify the theme using an object that includes the `mode`, `dark`, and `light` themes.
 995- Setting: `theme`
 996- Default:
 997
 998```json
 999"theme": {
1000  "mode": "dark",
1001  "dark": "One Dark",
1002  "light": "One Light"
1003},
1004```
1005
1006### Mode
1007
1008- Description: Specify theme mode.
1009- Setting: `mode`
1010- Default: `dark`
1011
1012**Options**
1013
10141. Set the theme to dark mode
1015
1016```json
1017{
1018  "mode": "dark"
1019}
1020```
1021
10222. Set the theme to light mode
1023
1024```json
1025{
1026  "mode": "light"
1027}
1028```
1029
10303. Set the theme to system mode
1031
1032```json
1033{
1034  "mode": "system"
1035}
1036```
1037
1038### Dark
1039
1040- Description: The name of the dark Zed theme to use for the UI.
1041- Setting: `dark`
1042- Default: `One Dark`
1043
1044**Options**
1045
1046Run the `theme selector: toggle` action in the command palette to see a current list of valid themes names.
1047
1048### Light
1049
1050- Description: The name of the light Zed theme to use for the UI.
1051- Setting: `light`
1052- Default: `One Light`
1053
1054**Options**
1055
1056Run the `theme selector: toggle` action in the command palette to see a current list of valid themes names.
1057
1058## Vim
1059
1060- Description: Whether or not to enable vim mode (work in progress).
1061- Setting: `vim_mode`
1062- Default: `false`
1063
1064## Project Panel
1065
1066- Description: Customise project panel
1067- Setting: `project_panel`
1068- Default:
1069
1070```json
1071"project_panel": {
1072  "dock": "left",
1073  "git_status": true,
1074  "default_width": "N/A - width in pixels"
1075},
1076```
1077
1078### Dock
1079
1080- Description: Control the position of the dock
1081- Setting: `dock`
1082- Default: `left`
1083
1084**Options**
1085
10861. Default dock position to left
1087
1088```json
1089{
1090  "dock": "left"
1091}
1092```
1093
10942. Default dock position to right
1095
1096```json
1097{
1098  "dock": "right"
1099}
1100```
1101
1102### Git Status
1103
1104- Description: Indicates newly created and updated files
1105- Setting: `git_status`
1106- Default: `true`
1107
11081. Default enable git status
1109
1110```json
1111{
1112  "git_status": true
1113}
1114```
1115
11162. Default disable git status
1117
1118```json
1119{
1120  "git_status": false
1121}
1122```
1123
1124### Default Width
1125
1126- Description: Customise default width taken by project panel
1127- Setting: `default_width`
1128- Default: N/A width in pixels (eg: 420)
1129
1130**Options**
1131
1132`boolean` values
1133
1134## An example configuration:
1135
1136```json
1137// ~/.config/zed/settings.json
1138{
1139  "theme": "cave-light",
1140  "tab_size": 2,
1141  "preferred_line_length": 80,
1142  "soft_wrap": "none",
1143
1144  "buffer_font_size": 18,
1145  "buffer_font_family": "Zed Mono",
1146
1147  "autosave": "on_focus_change",
1148  "format_on_save": "off",
1149  "vim_mode": false,
1150  "projects_online_by_default": true,
1151  "terminal": {
1152    "font_family": "FiraCode Nerd Font Mono",
1153    "blinking": "off"
1154  },
1155  "language_overrides": {
1156    "C": {
1157      "format_on_save": "language_server",
1158      "preferred_line_length": 64,
1159      "soft_wrap": "preferred_line_length"
1160    }
1161  }
1162}
1163```