Interface elements

SpaceVim has a minimalistic and distraction free UI:

• custom airline with color feedback according to current check status
• custom icon in sign column and error feedbacks for checker.

  Colorschemes

The default colorscheme of SpaceVim is gruvbox.There are two variants of this colorscheme, a dark one and a light one. Some aspectsof these colorscheme can be customized in the custom configuration file, read :h gruvbox.

It is possible to define your default themes in your ~/.SpaceVim.d/init.toml withthe variable colorschemes. For instance, to specify desert:

[options]
    colorscheme = "desert"
    colorscheme_bg = "dark"

all the included colorscheme can be found in colorscheme layer.

NOTE:

SpaceVim use true colors by default, so you should make sure your terminal support true colors.for more information see: Colours in terminal

If your terminal do not supports true colors, you can disable SpaceVim true colors featurein [options] section:

    enable_guicolors = false

Font

The default font used by SpaceVim is DejaVu Sans Mono for Powerline. It is recommendedto install it on your system if you wish to use it.

To change the default font set the variable guifont in your ~/.SpaceVim.d/init.toml file. By default its value is:

    guifont = 'DejaVu Sans Mono for Powerline:h11'

If the specified font is not found, the fallback one will be used (depends on your system).Also note that changing this value has no effect if you are running Vim/Neovim in terminal.

UI Toggles

Some UI indicators can be toggled on and off (toggles start with t and T):

Statusline

The core#statusline layer provide a heavily customized powerline with the following capabilities:

• show the window number
• show the current mode
• color code for current state
• show the index of searching result
• toggle syntax checking info
• toggle battery info
• toggle minor mode lighters
• show VCS information (branch, hunk summary) (need git and VersionControl layer)

Reminder of the color codes for the states:

all the colors based on the current colorscheme

Some elements can be dynamically toggled:

nerd font installation:

By default SpaceVim use nerd-fonts, please read the documentation of nerd fonts.

syntax checking integration:

When syntax checking minor mode is enabled, a new element appears showing the number of errors, warnings.

Search index integration:

Search index shows the number of occurrence when performing a search via / or ?. SpaceVim integrates nicely the search status by displaying it temporarily when n or N are being pressed. See the 20/22 segment on the screenshot below.

Battery status integration:

acpi displays the percentage of total charge of the battery as well as the time remaining to charge or discharge completely the battery.

A color code is used for the battery status:

all the colors based on the current colorscheme

Statusline separators:

It is possible to easily customize the statusline separator by setting the statusline_separator variable in your custom configuration file and then redraw the statusline. For instance if you want to set back the separator to the well-known arrow separator add the following snippet to your configuration file:

  statusline_separator = 'arrow'

here is an exhaustive set of screenshots for all the available separator:

Separator	Screenshot
arrow
curve
slant
nil
fire

Minor Modes:

The minor mode area can be toggled on and off with SPC t m m

Unicode symbols are displayed by default. Add statusline_unicode_symbols = false to your custom configuration file, statusline will display ASCII characters instead (may be useful in terminal if you cannot set an appropriate font).

The letters displayed in the statusline correspond to the key bindings used to toggle them.

colorscheme of statusline:

current version only support gruvbox/molokai/nord/one/onedark, if you want tocontribute theme please check the template of a statusline theme.

" the theme colors should be
" [
"    \ [ a_guifg,  a_guibg,  a_ctermfg,  a_ctermbg],
"    \ [ b_guifg,  b_guibg,  b_ctermfg,  b_ctermbg],
"    \ [ c_guifg,  c_guibg,  c_ctermfg,  c_ctermbg],
"    \ [ z_guibg,  z_ctermbg],
"    \ [ i_guifg,  i_guibg,  i_ctermfg,  i_ctermbg],
"    \ [ v_guifg,  v_guibg,  v_ctermfg,  v_ctermbg],
"    \ [ r_guifg,  r_guibg,  r_ctermfg,  r_ctermbg],
"    \ [ ii_guifg, ii_guibg, ii_ctermfg, ii_ctermbg],
"    \ [ in_guifg, in_guibg, in_ctermfg, in_ctermbg],
" \ ]
" group_a: window id
" group_b/group_c: stausline sections
" group_z: empty area
" group_i: window id in insert mode
" group_v: window id in visual mode
" group_r: window id in select mode
" group_ii: window id in iedit-insert mode
" group_in: windows id in iedit-normal mode
function! SpaceVim#mapping#guide#theme#gruvbox#palette() abort
    return [
                \ ['#282828', '#a89984', 246, 235],
                \ ['#a89984', '#504945', 239, 246],
                \ ['#a89984', '#3c3836', 237, 246],
                \ ['#665c54', 241],
                \ ['#282828', '#83a598', 235, 109],
                \ ['#282828', '#fe8019', 235, 208],
                \ ['#282828', '#8ec07c', 235, 108],
                \ ['#282828', '#689d6a', 235, 72],
                \ ['#282828', '#8f3f71', 235, 132],
                \ ]
endfunction

this example is for gruvbox colorscheme, if you want to use same colors whenswitch between different colorschemes, you may need to setcustom_color_palette in your custom configuration file. for example:

custom_color_palette = [
    ["#282828", "#a89984", 246, 235],
    ["#a89984", "#504945", 239, 246],
    ["#a89984", "#3c3836", 237, 246],
    ["#665c54", 241],
    ["#282828", "#83a598", 235, 109],
    ["#282828", "#fe8019", 235, 208],
    ["#282828", "#8ec07c", 235, 108],
    ["#282828", "#689d6a", 235, 72],
    ["#282828", "#8f3f71", 235, 132],
    ]

tabline

Buffers will be listed on tabline if there is only one tab, each item containsthe index, bufname and the filetype icon. if there are more than one tab, alltabs will be listed on the tabline. each item can be quickly accessed using<Leader> number. default <Leader> is \.

SpaceVim tabline also support mouse click, left mouse button will switch to buffer, middle button will delete the buffer.

NOTE: this feature is only supported in neovim with has('tablineat').

Tab manager:

You can also use SPC t t to open the tab manager windows.

key bindings within tab manager windows: