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.

• Annoucements
• Requirements
• Installation
• Interative Tutorials
• Guides
• See Also

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

• 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' }

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

• Create your new colorscheme with lush-template (and how to import a non-lush colorscheme)
• Extend an Lush existing colorscheme, or how users can configure your colorscheme
• Export your colorscheme to any format(s) with Shipwright
• FAQ

• Vim Help
• Change Log
• TODO