Back to Spacevim

SpaceVim colorscheme layer

docs/layers/colorscheme.md

2.4.02.5 KB
Original Source

Available Layers >> colorschemes

<!-- vim-markdown-toc GFM --> <!-- vim-markdown-toc -->

Description

This layer provides many Vim colorschemes for SpaceVim, the default colorscheme is gruvbox.

Install

This layer is disabled by default in SpaceVim.

To use this configuration layer, add this snippet to your custom configuration file.

toml
[[layers]]
  name = "colorscheme"

Configuration

To change the colorscheme:

toml
[options]
  colorscheme = "onedark"

Colorscheme list

Namedarklighttermguistatusline
molokaiyesnoyesyesyes
srceryyesnoyesyesyes
onedarkyesnoyesyesyes
jellybeansyesnoyesyesyes
palenightyesnoyesyesyes
oneyesyesyesyesyes
nordyesnoyesyesyes
gruvboxyesyesyesyesyes
NeoSolarizedyesyesyesyesyes
hybridyesyesyesyesyes
materialyesyesyesyesyes
draculayesyesyesyesyes
SpaceVimyesyesyesyesyes

By default this layer only includes above colorschemes. If you want to use other colorschemes which are available on Github, use the custom_plugins section in the configuration file. For example:

toml
[options]
  colorscheme = "OceanicNext"
  colorscheme_bg = "dark"

# add custom_plugins: https://github.com/mhartington/oceanic-next
[[custom_plugins]]
  repo = "mhartington/oceanic-next"
  merged = 0

Some colorschemes offer dark and light styles. Most of them are set by changing Vim's background color. SpaceVim supports changing the background color with colorscheme_bg:

toml
[options]
  colorscheme = "onedark"
  colorscheme_bg = "dark"

The colorscheme layer supports random colorschemes on startup. just load this layer with layer option random_theme

toml
[[layers]]
  name = "colorscheme"
  random_theme = true

The frequency can be changed via frequency layer option, the available values are daily, hourly, weekly. You can also use number + unit, for example: 1h.

toml
[[layers]]
  name = "colorscheme"
  random_theme = true
  frequency = "daily"