- Lua 41.7%
- Vim Script 39.5%
- Emacs Lisp 13.7%
- Shell 5.1%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
| colors | ||
| extra | ||
| lua | ||
| res | ||
| README.md | ||
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
- bufferline.nvim
- dashboard-nvim
- figet.nvim
- flash.nvim
- gitsigns.nvim
- headlines.nvim
- render-markdown.nvim
- indentmini.nvim
- lazy.nvim
- lualine.nvim
- mason.nvim
- mini-cursorword.md
- mini-diff.md
- mini-indentscope.md
- mini-jump.md
- mini-jump2d.md
- mini-starter.md
- mini-statusline.md
- mini-surround.md
- mini-tabline.md
- mini-trailspace.md
- noice.nvim
- nvim-lightbulb
- nvim-lspconfig
- nvim-navic
- nvim-notify
- nvim-scrollbar
- nvim-tree.lua
- nvim-web-devicons
- nvim_cmp
- oil.nvim
- rainbow-delimiters.nvim
- telescope.nvim
- todo-comments.nvim
- trouble.nvim
- vim-gitgutter
- which-key.nvim
- yanky.nvim
Acknowledgement
This is fork of https://github.com/slugbyte/lackluster.nvim. Thank you very much slugbyte



