Home

Neotheme wiki

Neotheme is a semantic, palette-driven theming engine for Neovim 0.12+. It ships one colorscheme entrypoint—neotheme—and lets you select a built-in variant or a custom semantic palette during setup.

Start here

• Configuration — installation, every setup option, and defaults.
• Themes and palette customization — the six Gruber variants, the simplified palette model, and palette changes.
• Integrations and Lualine — opt-in plugin highlights and the bundled Lualine theme.
• API and custom themes — public API and building a complete custom palette.

Requirements

• Neovim 0.12 or newer.
• A terminal or GUI with true-color support.

Minimal setup

require("neotheme").setup()
vim.cmd.colorscheme("neotheme")

The default is gruber-dark-muted. To select another family member, set theme before loading the same neotheme colorscheme:

require("neotheme").setup({
	theme = "gruber-light",
})
vim.cmd.colorscheme("neotheme")

Navigation

Use Configuration for a complete setup block, then continue to Themes and palette customization when you want to select or adjust a palette. Enable plugin surfaces through Integrations and Lualine after the base colorscheme is working. API and custom themes covers inspection and a fully custom palette.