Removing the clutter to reveal the essential.

All colors are configured directly through the terminal app of your choice. Colors are not hard-coded. Modern terminals allow 16 ANSI colors to be set to whatever 24-bit hex values you choose. This means you can set these colors to a precise shade. Since this theme inherits colors from terminal you can configure the look on the fly by directly adjusting colors in your terminal app. You will also get consistent look across shell commands.

Syntax highlighting is kept to a minimum. There is no advantage from readability perspective by assigning rainbow colors to every syntactic artifact, especially if those colors have no inherent meaning. I created this color scheme for my own use, and hopefully you will find it useful also.

Here are some colors I choose through iTerm2.

Neovim >= 8.0

Install the theme with your preferred package manager:

vim-plug

Plug 'girishji/declutter.nvim', { 'branch': 'main' }

packer

use 'girishji/declutter.nvim'

Lazy

require("lazy").setup({
  { "girishji/declutter.nvim" },
})

Note: Do not set termguicolors.

Enable the colorscheme:

" Vim Script
colorscheme declutter

-- Lua
vim.cmd[[colorscheme declutter]]

To enable the declutter theme from lazy.nvim:

 -- ... your lazy.nvim config
  {
    "girishji/declutter.nvim",
    priority = 1000,
    config = function()
      vim.cmd.colorscheme 'declutter'
    end,
  },  
   -- ... your lazy.nvim config

There is not much to configure. You could redefine highlight groups as follows.

❗️ configuration needs to be set BEFORE loading the color scheme

require("declutter").setup({
  highlights = {
    -- You can override specific highlight groups, either to use other colors
    --   link to another group
    -- To specify 'italic' style and black color for 'Comment':
    Comment = { ctermfg = 0, cterm = {italic = true} },
  },
})

To override colors use the configuration options of your terminal app. To override highlight groups refer to highlights in theme. Use the highlighs option passed to setup() function (above) to override color and style values.

Extra color configs for iTerm in extras.