charcoal.nvim

A warm and simple colorscheme.

This repository is derived from mubin-thinks/charcoal.

Preview | Install | Contribute

About

Charcoal is a warm colorscheme for text-editors, terminals, UI and more. The colorscheme resembles warm/rural weather, wheat field, afternoon sky etc. The dark background of Charcoal Dark is meant to help distinguish Code from UI. Charcoal is inspired by Gruvbox and Gruvbox Material colorschemes and tries to be simple and easy-on-eyes theme.

Preview

Install

Below are instructions to install Charcoal for different package managers:

folke/lazy.nvim:

{
    "mubin-thinks/charcoal.nvim",
    dependencies = { "nvim-mini/mini.base16" },
    priority = 1000,
    config = function()
        vim.cmd("colorscheme charcoal_monochrome")
    end
}

nvim-mini/mini.deps:

MiniDeps.now(function()
    MiniDeps.add({
        source = "mubin-thinks/charcoal.nvim",
        depends = { "nvim-mini/mini.base16" },
    })
    vim.cmd("colorscheme charcoal_monochrome")
end)

Switching between dark and light themes

Switching between light and dark themes are done through vim.o.background variable. To switch to dark theme (the default), set the variable to vim.o.background = 'dark' and vim.o.background = 'light' otherwise.

Preferable to add it right before vim.cmd("colorscheme charcoal_monochrome"). Here is an example with lazy.nvim:

{
    "mubin-thinks/charcoal.nvim",
    dependencies = { "nvim-mini/mini.base16" },
    priority = 1000,
    config = function()
        vim.o.background = 'light' -- enables light mode
        vim.cmd("colorscheme charcoal_monochrome")
    end
}

Contribute

If you would like to contribute to the project through posting an issue, please do so. But as a reminder this repository does not accept any suggestions to change the colorscheme. If you would like to suggest any change please refer to mubin-thinks/charcoal. I will kindly view your opinion, Insha'allah.