Skip to content
Switch branches/tags

Lush Header

Lush CI

Lush is aims to make colorscheme creation as painless as possible.

At its core, Lush presents your colorscheme as structured data, allowing you to manipulate it in any way you want.

It comes with as-you-edit feedback, a selection of color operation helpers, the ability for end users to extend and configure colorschemes, as well an API to export your colorscheme in any format, including a configurable lua colorscheme.

See some colorschemes Made with Lush.


  • 2021-11-05: Deprecation warning, the compiler exclude_keys option has been deprecated in favour of the build system,


  • Neovim 0.5 or greater required to use Lush as a development tool
  • termguicolors enabled for true color support


Install via any package management system, for example, paq:

require paq { 'rktjmp/lush.nvim' }

Interactive Tutorials

Lush Demo

There are two interactive tutorials provided,

  • :LushRunQuickstart which will give you a few-minute overview of Lush's creation features. (Or open lush_quick_start.lua in the examples folder.)

  • :LushRunTutorial, a more in-depth guide through various ways to apply Lush. (Or open lush_tutorial.lua in the examples folder).


See Also