Skip to content
A community-driven modular vim distribution - The ultimate vim configuration
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.SpaceVim.d Update Following HEAD page Mar 4, 2019
.ci Fix dein-ui detach Feb 13, 2019
.github Disable code owner message Jan 23, 2019
autoload Fix: add the missing parameter '...' (#2695) Mar 23, 2019
bin Improve server support in windows (#2597) Feb 17, 2019
colors fix vim script lint (#2519) Jan 28, 2019
doc Add option filetree_direction (#2661) Mar 13, 2019
docker Add docker spacevim (#2238) Oct 6, 2018
docs Add 3 key bindings SPC x t C, SPC x t W, SPC x t L (#2684) Mar 19, 2019
mode Finish renaming enable_statusline_display_mode to enable_statusline_m… Mar 4, 2019
reddit Add reddit Sidebar Jan 14, 2018
syntax Improve python support (#2555) Feb 3, 2019
test Fix spacevim rtp (#2550) Feb 2, 2019
wiki fix Vimfiler defx support (#2691) Mar 23, 2019
.editorconfig Add support for editorconfig Oct 4, 2017
.gitignore Add lsp support for java (#2619) Feb 23, 2019
.projections.json Add guide for using vim as ruby ide (#2603) Feb 25, 2019
.travis.yml Replace mode for flygrep (#1340) Feb 4, 2018
.vintrc.yaml update file head (#1407) Feb 19, 2018 Improve pull request template Jun 20, 2018
Makefile Fix Lint (#1945) Jul 15, 2018 Doc: fix typos. Jan 25, 2019 Doc: fix typos. (#2483) Jan 22, 2019
appveyor.yml Update to v1.1.0-dev (#2382) Dec 27, 2018
codecov.yml Disable codecov comment Jan 23, 2019
filetype.vim fix vim script lint (#2519) Jan 28, 2019
ginit.vim Fix neovim-qt default (#2348) Dec 15, 2018
init.vim Fix neovim py support (#1988) Jul 28, 2018
vimrc Enable nocompatible for vim May 2, 2018


Wiki | Documentation | Twitter | Community | Sponsors | Gitter Chat | 中文官网

Build Status Build status codecov Version GPLv3 License Doc Average time to resolve an issue Percentage of issues still open

About SpaceVim

SpaceVim is a community-driven modular Vim distribution. It manages collections of plugins in layers, which help to collect related packages together to provide IDE-like features. SpaceVim is not just a vimrc but an ultimate Vim configuration, It contains many built-in features.


The last release is v1.0.0, check out following-HEAD page for what happened since last release.


See the followings below for more information:

If you have any questions about SpaceVim, please follow the Getting Help Guide.

Here is a throughput graph of the repository for the last few weeks:

Throughput Graph

New Features

This is a list of latest features implemented in SpaceVim:

Use toml as default configuration

Here is an example for using toml as SpaceVim config:

# This is basic configuration example for SpaceVim.

# All SpaceVim options below [options] snippet.
    # Set SpaceVim theme. By default colorscheme layer is not loaded.
    # If you want to use more colorschemes, please load the colorscheme
    # layer.
    colorscheme = "gruvbox"
    colorscheme_bg = "dark"
    # Disable guicolors in basic mode, many terminal do not support 24bit
    # true colors
    enable_guicolors = false
    # Disable statusline separator, if you want to use other value, please
    # install nerd fonts
    statusline_separator = "nil"
    statusline_inactive_separator = "bar"
    buffer_index_type = 4
    windows_index_type = 3
    enable_tabline_filetype_icon = false
    enable_statusline_mode = false
    statusline_unicode_symbols = false
    # Enable Vim compatible mode, avoid changing origin Vim key bindings
    vimcompatible = true

# Enable autocomplete layer
    name = 'autocomplete'
    auto-completion-return-key-behavior = "complete"
    auto-completion-tab-key-behavior = "cycle"

    name = 'shell'
    default_position = 'top'
    default_height = 30

Iedit mode

SpaceVim uses a powerful iedit mode to quick edit multiple occurrences of a symbol or selection. Two new modes:iedit-Normal/iedit-Insert.

The default color for iedit is red/green which is based on the current colorscheme.

iedit mode

Highlight cursor symbol

SpaceVim supports highlighting of the current symbol on demand and adds a transient state to easily navigate and rename this symbol.

highlight cursor symbol

Fly Grep in Vim

With this feature, Vim will display the searching result as you type. Of course, it is running asynchronously. Before using this feature, you need to install a searching tool. FlyGrep works through search tools: ag, rg, ack, pt and grep, Choose one you like.

searching project

Mnemonic key bindings navigation

You don't need to remember any key bindings, as the mapping guide will show up after the SPC is pressed. The mapping guide is also available for g, z, and s.

mapping guide

Help description for key bindings

Use SPC h d k to get the help description of a key binding, and gd to find definition of key bindings.

describe key bindings

Asynchronous plugin manager

Create an UI for dein.vim - the best asynchronous vim plugin manager

UI for dein

For more features, please read SpaceVim's Blog

Project layout

├─ .ci/                           build automation
├─ .github/                       issue/PR templates
├─ .SpaceVim.d/                   project specific configuration
├─ autoload/SpaceVim.vim          SpaceVim core file
├─ autoload/SpaceVim/api/         Public APIs
├─ autoload/SpaceVim/layers/      available layers
├─ autoload/SpaceVim/plugins/     buildin plugins
├─ autoload/SpaceVim/mapping/     mapping guide
├─ doc/                           help(cn/en)
├─ docs/                          website(cn/en)
├─ wiki/                          wiki(cn/en)
├─ bin/                           executable
└─ test/                          tests

Support SpaceVim

The best way to support SpaceVim is to contribute to it either by reporting bugs. Helping the community on the Gitter Chat or sending pull requests.

For more information please check our development guidelines.

If you want to show your support financially you can buy a drink for the maintainer by clicking following icon.

Buy Me a Coffee at

wechat alipay

Bitcoin: 1DtuVeg81c2L9NEhDaVTAAbrCR3pN5xPFv

Credits & Thanks

This project exists to thank all the people who have contributed:

You can’t perform that action at this time.