A low-contrast, eye-friendly colorscheme for Neovim.
  • Lua 41.7%
  • Vim Script 39.5%
  • Emacs Lisp 13.7%
  • Shell 5.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-16 08:53:21 +03:00
colors first commit 2026-10-31 03:17:53 +03:00
extra new theme 2026-11-16 08:53:21 +03:00
lua new theme 2026-11-16 08:53:21 +03:00
res who care? 2026-11-05 00:58:25 +03:00
README.md new theme 2026-11-16 08:53:21 +03:00

ghostware-nvim

A low-contrast, eye-friendly colorscheme for Neovim.

Example

Ghostware

Spectreware

Augware

Rootware

Install (pack)

vim.pack.add({
  { src = "https://vcs.ghostware.tech/gortek/ghostware-nvim"},
})

vim.cmd.colorscheme("ghostware")

Presets

Ghostware

ghostware is the default low-contrast dark palette. It is selected automatically, so no setup() call is required:

vim.cmd.colorscheme("ghostware")

Spectreware

spectreware is the light counterpart of ghostware. Selecting it also sets vim.o.background = "light".

local ghostware = require("ghostware")

ghostware.setup({
    preset = "spectreware",
})

vim.cmd.colorscheme("ghostware")

Augware

augware is a dark preset with a Deus Ex vibe: a warm, almost black base, muted brass chrome and amber keywords.

local ghostware = require("ghostware")

ghostware.setup({
    preset = "augware",
})

vim.cmd.colorscheme("ghostware")

Rootware

rootware takes its cue from Mr. Robot: near-black graphite surfaces, restrained terminal colors, and a muted red accent for selections, search, and control flow.

local ghostware = require("ghostware")

ghostware.setup({
    preset = "rootware",
})

vim.cmd.colorscheme("ghostware")

Proofware

proofware is a near-monochrome editorial dark preset: a neutral black canvas, warm paper-ink grays and a single accent, Proof Red, used like a proofreader's mark (errors, exceptions, deletions). Keywords, operators, punctuation and comments (italic) all sit in the same quiet "grammar" tier, so identifiers and calls stand out without any hues.

local ghostware = require("ghostware")

ghostware.setup({
    preset = "proofware",
})

vim.cmd.colorscheme("ghostware")

Paperware

paperware is the light counterpart of proofware: a warm paper canvas, dark ink grays and the same Proof Red, darkened to sit on paper. Selecting it also sets vim.o.background = "light".

local ghostware = require("ghostware")

ghostware.setup({
    preset = "paperware",
})

vim.cmd.colorscheme("ghostware")
Role Proofware Paperware
Canvas #101010 #F2F0EA
Ink / primary #D8D5CE #292826
Secondary #B8B5AF #4E4D49
Grammar / informational line numbers #7E7C77 #6E6B65
Keywords #85837D #68655F
Operators #807E78 #6E6B65
Punctuation / delimiters #7E7C77 #6F6C66
Comments #7E7C77 italic #6F6C66 italic
Muted text on tonal fills #8F8D86 #5C5954
Proof Red #B04A43 #913832
Rare emphasis #ECE9E2 #171614
Rule #343330 #D3D0C8
Guide #4A4843 #BDBAB2
Selection #302F2B #E2DFD8

There are no hues in these two palettes: the orange, yellow, green, blue, purple and cyan slots are filled with tones from the ink ramp, so every plugin that reads them stays on palette. Only red carries color. If you find return/throw in Proof Red too loud, neutralize them with tweak_syntax = { keyword_return = "default", keyword_exception = "default" } or set them to any hexcode.

Available built-in presets: ghostware (default), spectreware, augware, rootware, proofware, paperware.

Palette definitions live in lua/ghostware/palettes/. Each palette is a self-contained module with colors, special, an optional background ("dark" or "light"), and an optional apply(theme, color, color_special) hook for preset-specific UI/plugin adjustments.

Besides theme.ui, theme.plugin_* and the other tables, the apply hook can set theme.syntax_default.operator (operators default to the punctuation tone), theme.style.comment (extra nvim_set_hl keys for comments, e.g. { italic = true }) and theme.ui.fg_indent / theme.ui.fg_indent_cur (indent guides). All of them default to the previous behavior, so existing palettes are unaffected.

Standalone ports of all six palettes for other tools (Ghostty, Emacs, Vim, Fish, Konsole, Foot, Xresources) live in extra/.

Lualine

require("lualine").setup({ options = { theme = "ghostware" } })

Call ghostware.setup() before initializing lualine when using a preset, so the lualine theme is generated from the selected palette.

Tweaking

(OPTIONAL) Tweak Color Pallet

!! setup() MUST be called before setting your colorscheme !!

local ghostware = require("ghostware")

-- !must called setup() before setting the colorscheme!
ghostware.setup({
    -- tweak_color allows you to overwrite the default colors in the ghostware theme
    tweak_color = {
        -- you can set a value to a custom hexcode like' #aaaa77' (hashtag required)
        -- or if the value is 'default' or nil it will use ghostware default color
        orange = "default",
        yellow = "default",
        green = "default",
        blue = "default",
        red = "default",
        -- WARN: Watchout! messing with grays is probs a bad idea, its very easy to shoot yourself in the foot!
        -- black = "default",
        -- gray1 = "default",
        -- gray2 = "default",
        -- gray3 = "default",
        -- gray4 = "default",
        -- gray5 = "default",
        -- gray6 = "default",
        -- gray7 = "default",
        -- gray8 = "default",
        -- gray9 = "default",

    },
})

-- !must set colorscheme after calling setup()!
vim.cmd.colorscheme("ghostware")
(OPTIONAL) Tweak Syntax Colors and Background Transparency

!! setup() MUST be called before setting your colorscheme !!

local ghostware = require("ghostware")

local color = ghostware.color -- blue, green, red, orange, black, gray1-9

-- !must called setup() before setting the colorscheme!
ghostware.setup({
    -- You can overwrite the following syntax colors by setting them to one of...
    --   1) a hexcode like "#a1b2c3" for a custom color.
    --   2) "default" or nil will just use whatever ghostware default is.
    tweak_syntax = {
        string = "default",
        -- string = "#a1b2c3", -- custom hexcode
        -- string = color.green, -- ghostware color
        string_escape = "default",
        comment = "default",
        builtin = "default", -- builtin modules and functions
        type = "default",
        keyword = "default",
        keyword_return = "default",
        keyword_exception = "default",
    },
    -- You can overwrite the following background colors by setting them to one of...
    --   1) a hexcode like "#a1b2c3" for a custom color
    --   2) "none" for transparency
    --   3) "default" or nil will just use whatever ghostware default is.
    tweak_background = {
        normal = 'default',    -- main background
        -- normal = 'none',    -- transparent
        -- normal = '#a1b2c3',    -- hexcode 
        -- normal = color.green,    -- ghostware color
        telescope = 'default', -- telescope
        menu = 'default',      -- nvim_cmp, wildmenu ... (bad idea to transparent)
        popup = 'default',     -- lazy, mason, whichkey ... (bad idea to transparent)
    },
})

-- !must set colorscheme after calling setup()!
vim.cmd.colorscheme("ghostware")

Example transparent background setup()

--  When testing transparent backgrounds I found that comments where often hard to read, 
--  and menus didn't look good but using setup() tweaks you can easily address that!
local ghostware = require("ghostware")

-- !must called setup() before setting the colorscheme!
ghostware.setup({
    tweak_syntax = {
        comment = ghostware.color.gray4, -- or gray5
    },
    tweak_background = {
        normal = 'none',
        telescope = 'none',
        menu = ghostware.color.gray3,
        popup = 'default',
    },
})

-- !must set colorscheme after calling setup()!
vim.cmd.colorscheme("ghostware")
(OPTIONAL) Tweak UI

!! setup() MUST be called before setting your colorscheme !!

local ghostware = require("ghostware")

-- !must called setup() before setting the colorscheme!
ghostware.setup({
    tweak_ui = {
        disable_undercurl = false, -- set to true if you want underline instead of undercurl
        enable_end_of_buffer = false, -- set to true to show the end_of_buffer ~ symbols in the gutter
    },
})

-- !must set colorscheme after calling setup()!
vim.cmd.colorscheme("ghostware")
(OPTIONAL) Tweak Highlights Manually (bold, italic, etc...)
local ghostware = require("ghostware")

-- !must called setup() before setting the colorscheme!
ghostware.setup({
    -- tweak_highlight allows you to update or overwrite the value passed into
    -- vim.api.nvim_set_hl which allows you to have complete control over modifying all
    -- highlights on a granular level.
    tweak_highlight = {
      -- modify @keyword's highlights to be bold and italic
      ["@keyword"] = {
        overwrite = false, -- overwrite falsey will extend/update ghostware defaults (nil also does this)
        bold = true,
        italic = true,
        -- see `:help nvim_set_hl` for all possible keys
      },
      -- overwrite @function to link to @keyword
      ["@function"] = {
        overwrite = true, -- overwrite == true will force overwrite ghostware's default highlights
        link = "@keyword",
      },
    },
})

-- !must set colorscheme after calling setup()!
vim.cmd.colorscheme("ghostware")
(OPTIONAL) Tweak Disable Plugin Highlights

!! setup() MUST be called before setting your colorscheme !!

local ghostware = require("ghostware")

-- if for some reason you want to disable the highlights related to a specific plugin you 
-- can set any of these to true and the highlights will not be set

-- !must called setup() before setting the colorscheme!
ghostware.setup({
    disable_plugin = {
        bufferline = false,
        cmp = false,
        dashboard = false,
        flash = false,
        git_gutter = false,
        git_signs = false,
        headline = false,
        indentmini = false,
        lazy = false,
        lightbulb = false,
        lsp_config = false,
        mason = false,
        mini_diff = false,
        navic = false,
        noice = false,
        notify = false,
        oil = false,
        rainbow_delimiter = false, -- if you want color-rainbows you should disable this
		render_markdown = false,
        scollbar = false,
        telescope = false,
        todo_comments = false,
        tree = false,
        trouble = false,
        which_key = false,
        yanky = false,
    },
})

-- !must set colorscheme after calling setup()!
vim.cmd.colorscheme("ghostware")
(OPTIONAL) Setup nvim-web-devicons

-- nvim-web-devicons does not play well with colorschemes so if ghostware style icons
-- run the following setup before you load ghostware.
local ghostware = require("ghostware")
-- !must called setup() before setting the colorscheme!
require('nvim-web-devicons').setup({
    color_icons = false,
    override = {
        ["default_icon"] = {
            color = ghostware.color.gray4,
            name = "Default",
        }
    }
})
vim.cmd.colorscheme("ghostware")

Supported plugins

Acknowledgement

This is fork of https://github.com/slugbyte/lackluster.nvim. Thank you very much slugbyte