/coal.nvim

A dark theme for NeoVim

Primary LanguageLuaMIT LicenseMIT

coal.nvim

A simple, mostly greyscale theme for NeoVim.

The theme doesn't use any accent colours. There are shades of black and grey only. The diff view is gray scaled too. Only exceptions is for LSP warning and errors which have standard orange and red colours.

Screenshots

Lua

Screenshot 2022-09-08 at 21 03 19

C# with errors and warnings

Screenshot 2022-09-08 at 21 04 26

Telescope

Screenshot 2022-09-08 at 21 06 28

The diff view

Screenshot 2022-09-08 at 21 09 27

Supported plugins highlight groups

  • LSP
  • nvim-treesitter
  • vim-fugitive
  • Telescope

Installation

Install with your packer manager, e.g. Packer:

use({
    'cranberry-clockworks/coal.nvim',
    config = function()
        require('coal').setup()
    end
})

or use the VIM command:

colorscheme coal

Colour palette

There are only 9 colours are defined:

  • smoky_black = #0C0C0C
  • eerie_black = #1A1A1A
  • raisin_black = #262626
  • dark_charcoal = #303030
  • gray = #7E7E7E
  • quick_silver = #A5A5A5
  • chinese_silver = #CCCCCC
  • anti_flash_white = #F2F2F2
  • white = #FFFFFF

The main goal was picking up colours while keeping good readability and contrast ratios.

Base colours overriding

Base colours could be overridden. Could be helpful to make background colour completely black:

require('coal').setup({
    colors = {
        smoky_black = '#000000'
    }
}

Further development

The theme is completed for my setup and I won't be contribute to it for a while. But feel free to modify or extend for your needs 🙂