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

    The default colorscheme of SpaceVim is .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 .

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

    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:

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

    1. enable_guicolors = false

    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:

    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.

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

    Key Binding Description
    SPC t 8 highlight any character past the 80th column
    SPC t f display the fill column (by default max_column is 120)
    SPC t h h toggle highlight of the current line
    SPC t h i toggle highlight indentation levels (TODO)
    SPC t h c toggle highlight indentation current column
    SPC t h s toggle syntax highlighting
    SPC t i toggle indentation guide at point
    SPC t n toggle line numbers
    SPC t b toggle background
    SPC t t open tabs manager
    SPC T ~ display ~ in the fringe on empty lines
    SPC T F toggle frame fullscreen
    SPC T f toggle display of the fringe
    SPC T m toggle menu bar
    SPC T t toggle tool bar

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

    • 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)
    Key bindings Description
    SPC [1-9] jump to the windows with the specific number

    Reminder of the color codes for the states:

    all the colors based on the current colorscheme

    Key Binding Description
    SPC t m b toggle the battery status (need to install acpi)
    SPC t m c toggle the org task clock (available in org layer)(TODO)
    SPC t m m toggle the minor mode lighters
    SPC t m M toggle the major mode
    toggle the cat! (if colors layer is declared in your dotfile)(TODO)
    SPC t m p toggle the cursor position
    SPC t m t toggle the time
    SPC t m d toggle the date
    SPC t m T toggle the mode line itself
    SPC t m v toggle the version control info

    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:

    Battery State Color
    Charging Green
    Discharging Orange
    Critical Red

    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:

    1. statusline_separator = 'arrow'

    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.

    Key Binding Unicode ASCII Mode
    SPC t 8 8 toggle highlight of characters for long lines
    SPC t f f fill-column-indicator mode
    SPC t s s syntax checking (neomake)
    SPC t S S enabled in spell checking
    SPC t w w whitespace mode

    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.

    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:

    1. ["#282828", "#a89984", 246, 235],
    2. ["#a89984", "#504945", 239, 246],
    3. ["#665c54", 241],
    4. ["#282828", "#83a598", 235, 109],
    5. ["#282828", "#fe8019", 235, 208],
    6. ["#282828", "#8ec07c", 235, 108],
    7. ["#282828", "#689d6a", 235, 72],
    8. ]

    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 \.

    Key Binding Description
    <Leader> 1 Jump to index 1 on tabline
    <Leader> 2 Jump to index 2 on tabline
    <Leader> 3 Jump to index 3 on tabline
    <Leader> 4 Jump to index 4 on tabline
    <Leader> 5 Jump to index 5 on tabline
    <Leader> 6 Jump to index 6 on tabline
    <Leader> 7 Jump to index 7 on tabline
    <Leader> 8 Jump to index 8 on tabline
    <Leader> 9 Jump to index 9 on tabline

    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:

    Key Binding Description
    o Close or expand tab windows.
    r Rename the tab under the cursor.
    n Create new named tab below the cursor tab
    N Create new tab below the cursor tab
    x Delete the tab
    <C-S-Up> Move tab backward
    <C-S-Down> Move tab forward
    Jump to windows under the cursor.