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## Auto close
 310
 311- Description: Whether or not to automatically type closing characters for you.
 312- Setting: `use_autoclose`
 313- Default: `true`
 314
 315**Options**
 316
 317`boolean` values
 318
 319## Git
 320
 321- Description: Configuration for git-related features.
 322- Setting: `git`
 323- Default:
 324
 325```json
 326"git": {
 327  "git_gutter": "tracked_files"
 328},
 329```
 330
 331### Git Gutter
 332
 333- Description: Whether or not to show the git gutter.
 334- Setting: `git_gutter`
 335- Default: `tracked_files`
 336
 337**Options**
 338
 3391. Show git gutter in tracked files
 340
 341```json
 342{
 343  "git_gutter": "tracked_files"
 344}
 345```
 346
 3472. Hide git gutter
 348
 349```json
 350{
 351  "git_gutter": "hide"
 352}
 353```
 354
 355## Hard Tabs
 356
 357- Description: Whether to indent lines using tab characters or multiple spaces.
 358- Setting: `hard_tabs`
 359- Default: `false`
 360
 361**Options**
 362
 363`boolean` values
 364
 365## Hover Popover Enabled
 366
 367- Description: Whether or not to show the informational hover box when moving the mouse over symbols in the editor.
 368- Setting: `hover_popover_enabled`
 369- Default: `true`
 370
 371**Options**
 372
 373`boolean` values
 374
 375## Inlay hints
 376
 377- Description: Configuration for displaying extra text with hints in the editor.
 378- Setting: `inlay_hints`
 379- Default:
 380
 381```json
 382"inlay_hints": {
 383  "enabled": false,
 384  "show_type_hints": true,
 385  "show_parameter_hints": true,
 386  "show_other_hints": true
 387}
 388```
 389
 390**Options**
 391
 392Inlay hints querying consists of two parts: editor (client) and LSP server.
 393With 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.
 394At 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.
 395
 396Use `lsp` section for the server configuration, below are some examples for well known servers:
 397
 398### Rust
 399
 400```json
 401"lsp": {
 402  "rust-analyzer": {
 403    "initialization_options": {
 404      "inlayHints": {
 405        "maxLength": null,
 406        "lifetimeElisionHints": {
 407          "useParameterNames": true,
 408          "enable": "skip_trivial"
 409        },
 410        "closureReturnTypeHints": {
 411          "enable": "always"
 412        }
 413      }
 414    }
 415  }
 416}
 417```
 418
 419### Typescript
 420
 421```json
 422"lsp": {
 423  "typescript-language-server": {
 424    "initialization_options": {
 425      "preferences": {
 426        "includeInlayParameterNameHints": "all",
 427        "includeInlayParameterNameHintsWhenArgumentMatchesName": true,
 428        "includeInlayFunctionParameterTypeHints": true,
 429        "includeInlayVariableTypeHints": true,
 430        "includeInlayVariableTypeHintsWhenTypeMatchesName": false,
 431        "includeInlayPropertyDeclarationTypeHints": true,
 432        "includeInlayFunctionLikeReturnTypeHints": true,
 433        "includeInlayEnumMemberValueHints": true
 434      }
 435    }
 436  }
 437}
 438```
 439
 440### Go
 441
 442```json
 443"lsp": {
 444  "gopls": {
 445    "initialization_options": {
 446      "hints": {
 447        "assignVariableTypes": true,
 448        "compositeLiteralFields": true,
 449        "compositeLiteralTypes": true,
 450        "constantValues": true,
 451        "functionTypeParameters": true,
 452        "parameterNames": true,
 453        "rangeVariableTypes": true
 454      }
 455    }
 456  }
 457}
 458```
 459
 460### Svelte
 461
 462```json
 463{
 464  "lsp": {
 465    "typescript-language-server": {
 466      "initialization_options": {
 467        "preferences": {
 468          "includeInlayParameterNameHints": "all",
 469          "includeInlayParameterNameHintsWhenArgumentMatchesName": true,
 470          "includeInlayFunctionParameterTypeHints": true,
 471          "includeInlayVariableTypeHints": true,
 472          "includeInlayVariableTypeHintsWhenTypeMatchesName": false,
 473          "includeInlayPropertyDeclarationTypeHints": true,
 474          "includeInlayFunctionLikeReturnTypeHints": true,
 475          "includeInlayEnumMemberValueHints": true,
 476          "includeInlayEnumMemberDeclarationTypes": true
 477        }
 478      }
 479    }
 480  }
 481}
 482```
 483
 484## Journal
 485
 486- Description: Configuration for the journal.
 487- Setting: `journal`
 488- Default:
 489
 490```json
 491"journal": {
 492  "path": "~",
 493  "hour_format": "hour12"
 494}
 495```
 496
 497### Path
 498
 499- Description: The path of the directory where journal entries are stored.
 500- Setting: `path`
 501- Default: `~`
 502
 503**Options**
 504
 505`string` values
 506
 507### Hour Format
 508
 509- Description: The format to use for displaying hours in the journal.
 510- Setting: `hour_format`
 511- Default: `hour12`
 512
 513**Options**
 514
 5151. 12-hour format:
 516
 517```json
 518{
 519  "hour_format": "hour12"
 520}
 521```
 522
 5232. 24-hour format:
 524
 525```json
 526{
 527  "hour_format": "hour24"
 528}
 529```
 530
 531## Language Overrides
 532
 533- Description: Configuration overrides for specific languages.
 534- Setting: `language_overrides`
 535- Default: `null`
 536
 537**Options**
 538
 539To override settings for a language, add an entry for that languages name to the `language_overrides` value. Example:
 540
 541```json
 542"language_overrides": {
 543  "C": {
 544    "format_on_save": "off",
 545    "preferred_line_length": 64,
 546    "soft_wrap": "preferred_line_length"
 547  },
 548  "JSON": {
 549    "tab_size": 4
 550  }
 551}
 552```
 553
 554The following settings can be overridden for each specific language:
 555
 556- `enable_language_server`
 557- `ensure_final_newline_on_save`
 558- `format_on_save`
 559- `formatter`
 560- `hard_tabs`
 561- `preferred_line_length`
 562- `remove_trailing_whitespace_on_save`
 563- `show_copilot_suggestions`
 564- `show_whitespaces`
 565- `soft_wrap`
 566- `tab_size`
 567
 568These values take in the same options as the root-level settings with the same name.
 569
 570## Preferred Line Length
 571
 572- Description: The column at which to soft-wrap lines, for buffers where soft-wrap is enabled.
 573- Setting: `preferred_line_length`
 574- Default: `80`
 575
 576**Options**
 577
 578`integer` values
 579
 580## Projects Online By Default
 581
 582- Description: Whether or not to show the online projects view by default.
 583- Setting: `projects_online_by_default`
 584- Default: `true`
 585
 586**Options**
 587
 588`boolean` values
 589
 590## Remove Trailing Whitespace On Save
 591
 592- Description: Whether or not to remove any trailing whitespace from lines of a buffer before saving it.
 593- Setting: `remove_trailing_whitespace_on_save`
 594- Default: `true`
 595
 596**Options**
 597
 598`boolean` values
 599
 600## Semantic Index
 601
 602- Description: Settings related to semantic index.
 603- Setting: `semantic_index`
 604- Default:
 605
 606```json
 607"semantic_index": {
 608  "enabled": false
 609},
 610```
 611
 612### Enabled
 613
 614- Description: Whether or not to display the `Semantic` mode in project search.
 615- Setting: `enabled`
 616- Default: `true`
 617
 618**Options**
 619
 620`boolean` values
 621
 622## Show Call Status Icon
 623
 624- Description: Whether or not to show the call status icon in the status bar.
 625- Setting: `show_call_status_icon`
 626- Default: `true`
 627
 628**Options**
 629
 630`boolean` values
 631
 632## Show Completions On Input
 633
 634- Description: Whether or not to show completions as you type.
 635- Setting: `show_completions_on_input`
 636- Default: `true`
 637
 638**Options**
 639
 640`boolean` values
 641
 642## Show Completion Documentation
 643
 644- Description: Whether to display inline and alongside documentation for items in the completions menu.
 645- Setting: `show_completion_documentation`
 646- Default: `true`
 647
 648**Options**
 649
 650`boolean` values
 651
 652## Completion Documentation Debounce Delay
 653
 654- Description: The debounce delay before re-querying the language server for completion documentation when not included in original completion list.
 655- Setting: `completion_documentation_secondary_query_debounce`
 656- Default: `300` ms
 657
 658**Options**
 659
 660`integer` values
 661
 662## Show Copilot Suggestions
 663
 664- Description: Whether or not to show Copilot suggestions as you type or wait for a `copilot::Toggle`.
 665- Setting: `show_copilot_suggestions`
 666- Default: `true`
 667
 668**Options**
 669
 670`boolean` values
 671
 672## Show Whitespaces
 673
 674- Description: Whether or not to show render whitespace characters in the editor.
 675- Setting: `show_whitespaces`
 676- Default: `selection`
 677
 678**Options**
 679
 6801. `all`
 6812. `selection`
 6823. `none`
 683
 684## Soft Wrap
 685
 686- Description: Whether or not to automatically wrap lines of text to fit editor / preferred width.
 687- Setting: `soft_wrap`
 688- Default: `none`
 689
 690**Options**
 691
 6921. `editor_width`
 6932. `preferred_line_length`
 6943. `none`
 695
 696## Tab Size
 697
 698- Description: The number of spaces to use for each tab character.
 699- Setting: `tab_size`
 700- Default: `4`
 701
 702**Options**
 703
 704`integer` values
 705
 706## Telemetry
 707
 708- Description: Control what info is collected by Zed.
 709- Setting: `telemetry`
 710- Default:
 711
 712```json
 713"telemetry": {
 714  "diagnostics": true,
 715  "metrics": true
 716},
 717```
 718
 719**Options**
 720
 721### Diagnostics
 722
 723- Description: Setting for sending debug-related data, such as crash reports.
 724- Setting: `diagnostics`
 725- Default: `true`
 726
 727**Options**
 728
 729`boolean` values
 730
 731### Metrics
 732
 733- Description: Setting for sending anonymized usage data, such what languages you're using Zed with.
 734- Setting: `metrics`
 735- Default: `true`
 736
 737**Options**
 738
 739`boolean` values
 740
 741## Terminal
 742
 743- Description: Configuration for the terminal.
 744- Setting: `terminal`
 745- Default:
 746
 747```json
 748"terminal": {
 749  "alternate_scroll": "off",
 750  "blinking": "terminal_controlled",
 751  "copy_on_select": false,
 752  "env": {},
 753  "font_family": null,
 754  "font_features": null,
 755  "font_size": null,
 756  "option_as_meta": false,
 757  "shell": {},
 758  "working_directory": "current_project_directory"
 759}
 760```
 761
 762### Alternate Scroll
 763
 764- 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.
 765- Setting: `alternate_scroll`
 766- Default: `off`
 767
 768**Options**
 769
 7701. Default alternate scroll mode to on
 771
 772```json
 773{
 774  "alternate_scroll": "on"
 775}
 776```
 777
 7782. Default alternate scroll mode to off
 779
 780```json
 781{
 782  "alternate_scroll": "off"
 783}
 784```
 785
 786### Blinking
 787
 788- Description: Set the cursor blinking behavior in the terminal
 789- Setting: `blinking`
 790- Default: `terminal_controlled`
 791
 792**Options**
 793
 7941. Never blink the cursor, ignore the terminal mode
 795
 796```json
 797{
 798  "blinking": "off"
 799}
 800```
 801
 8022. Default the cursor blink to off, but allow the terminal to turn blinking on
 803
 804```json
 805{
 806  "blinking": "terminal_controlled"
 807}
 808```
 809
 8103. Always blink the cursor, ignore the terminal mode
 811
 812```json
 813"blinking": "on",
 814```
 815
 816### Copy On Select
 817
 818- Description: Whether or not selecting text in the terminal will automatically copy to the system clipboard.
 819- Setting: `copy_on_select`
 820- Default: `false`
 821
 822**Options**
 823
 824`boolean` values
 825
 826### Env
 827
 828- 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
 829- Setting: `env`
 830- Default: `{}`
 831
 832**Example**
 833
 834```json
 835"env": {
 836  "ZED": "1",
 837  "KEY": "value1:value2"
 838}
 839```
 840
 841### Font Size
 842
 843- Description: What font size to use for the terminal. When not set defaults to matching the editor's font size
 844- Setting: `font_size`
 845- Default: `null`
 846
 847**Options**
 848
 849`integer` values
 850
 851### Font Family
 852
 853- Description: What font to use for the terminal. When not set, defaults to matching the editor's font.
 854- Setting: `font_family`
 855- Default: `null`
 856
 857**Options**
 858
 859The name of any font family installed on the user's system
 860
 861### Font Features
 862
 863- Description: What font features to use for the terminal. When not set, defaults to matching the editor's font features.
 864- Setting: `font_features`
 865- Default: `null`
 866
 867**Options**
 868
 869See Buffer Font Features
 870
 871### Option As Meta
 872
 873- Description: Re-interprets the option keys to act like a 'meta' key, like in Emacs.
 874- Setting: `option_as_meta`
 875- Default: `true`
 876
 877**Options**
 878
 879`boolean` values
 880
 881### Shell
 882
 883- Description: What shell to use when launching the terminal.
 884- Setting: `shell`
 885- Default: `system`
 886
 887**Options**
 888
 8891. Use the system's default terminal configuration (usually the `/etc/passwd` file).
 890
 891```json
 892{
 893  "shell": "system"
 894}
 895```
 896
 8972. A program to launch:
 898
 899```json
 900"shell": {
 901    "program": "sh"
 902}
 903```
 904
 9053. A program with arguments:
 906
 907```json
 908"shell": {
 909  "with_arguments": {
 910    "program": "/bin/bash",
 911    "args": ["--login"]
 912  }
 913}
 914```
 915
 916### Working Directory
 917
 918- Description: What working directory to use when launching the terminal.
 919- Setting: `working_directory`
 920- Default: `"current_project_directory"`
 921
 922**Options**
 923
 9241. Use the current file's project directory. Will Fallback to the first project directory strategy if unsuccessful
 925
 926```json
 927{
 928  "working_directory": "current_project_directory"
 929}
 930```
 931
 9322. Use the first project in this workspace's directory. Will fallback to using this platform's home directory.
 933
 934```json
 935{
 936  "working_directory": "first_project_directory"
 937}
 938```
 939
 9403. Always use this platform's home directory (if we can find it)
 941
 942```json
 943{
 944  "working_directory": "always_home"
 945}
 946```
 947
 9484. 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.
 949
 950```json
 951"working_directory": {
 952  "always": {
 953    "directory": "~/zed/projects/"
 954  }
 955}
 956```
 957
 958## Theme
 959
 960- 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.
 961- Setting: `theme`
 962- Default: `One Dark`
 963
 964### Theme Object
 965
 966- Description: Specify the theme using an object that includes the `mode`, `dark`, and `light` themes.
 967- Setting: `theme`
 968- Default:
 969
 970```json
 971"theme": {
 972  "mode": "dark",
 973  "dark": "One Dark",
 974  "light": "One Light"
 975},
 976```
 977
 978### Mode
 979
 980- Description: Specify theme mode.
 981- Setting: `mode`
 982- Default: `dark`
 983
 984**Options**
 985
 9861. Set the theme to dark mode
 987
 988```json
 989{
 990  "mode": "dark"
 991}
 992```
 993
 9942. Set the theme to light mode
 995
 996```json
 997{
 998  "mode": "light"
 999}
1000```
1001
10023. Set the theme to system mode
1003
1004```json
1005{
1006  "mode": "system"
1007}
1008```
1009
1010### Dark
1011
1012- Description: The name of the dark Zed theme to use for the UI.
1013- Setting: `dark`
1014- Default: `One Dark`
1015
1016**Options**
1017
1018Run the `theme selector: toggle` action in the command palette to see a current list of valid themes names.
1019
1020### Light
1021
1022- Description: The name of the light Zed theme to use for the UI.
1023- Setting: `light`
1024- Default: `One Light`
1025
1026**Options**
1027
1028Run the `theme selector: toggle` action in the command palette to see a current list of valid themes names.
1029
1030## Vim
1031
1032- Description: Whether or not to enable vim mode (work in progress).
1033- Setting: `vim_mode`
1034- Default: `false`
1035
1036## Project Panel
1037
1038- Description: Customise project panel
1039- Setting: `project_panel`
1040- Default:
1041
1042```json
1043"project_panel": {
1044  "dock": "left",
1045  "git_status": true,
1046  "default_width": "N/A - width in pixels"
1047},
1048```
1049
1050### Dock
1051
1052- Description: Control the position of the dock
1053- Setting: `dock`
1054- Default: `left`
1055
1056**Options**
1057
10581. Default dock position to left
1059
1060```json
1061{
1062  "dock": "left"
1063}
1064```
1065
10662. Default dock position to right
1067
1068```json
1069{
1070  "dock": "right"
1071}
1072```
1073
1074### Git Status
1075
1076- Description: Indicates newly created and updated files
1077- Setting: `git_status`
1078- Default: `true`
1079
10801. Default enable git status
1081
1082```json
1083{
1084  "git_status": true
1085}
1086```
1087
10882. Default disable git status
1089
1090```json
1091{
1092  "git_status": false
1093}
1094```
1095
1096### Default Width
1097
1098- Description: Customise default width taken by project panel
1099- Setting: `default_width`
1100- Default: N/A width in pixels (eg: 420)
1101
1102**Options**
1103
1104`boolean` values
1105
1106## An example configuration:
1107
1108```json
1109// ~/.config/zed/settings.json
1110{
1111  "theme": "cave-light",
1112  "tab_size": 2,
1113  "preferred_line_length": 80,
1114  "soft_wrap": "none",
1115
1116  "buffer_font_size": 18,
1117  "buffer_font_family": "Zed Mono",
1118
1119  "autosave": "on_focus_change",
1120  "format_on_save": "off",
1121  "vim_mode": false,
1122  "projects_online_by_default": true,
1123  "terminal": {
1124    "font_family": "FiraCode Nerd Font Mono",
1125    "blinking": "off"
1126  },
1127  "language_overrides": {
1128    "C": {
1129      "format_on_save": "language_server",
1130      "preferred_line_length": 64,
1131      "soft_wrap": "preferred_line_length"
1132    }
1133  }
1134}
1135```