Home

Neotheme documentation

Neotheme is a semantic, palette-driven colorscheme for Neovim 0.12 and newer. It provides six coordinated Gruber themes, one colorscheme entrypoint, complete editor and language highlights, terminal colors, Lualine support, and opt-in plugin integrations.

Start here

• New installation: Getting Started
• Every setup option and default: Configuration
• Choose a built-in variant: Themes
• Change semantic colors: Palette Customization
• Build a palette from scratch: Custom Themes
• Enable plugin support: Integrations
• Configure the bundled statusline theme: Lualine
• Use the Lua interface: API
• Diagnose a problem: Troubleshooting

Contributor and internals reference

• Runtime design and state flow: Architecture
• Owned highlights and terminal mappings: Highlight Groups
• Add a built-in family or variant: Theme Authoring
• Format, test, and contribute: Development

Requirements

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

Neotheme enables termguicolors when it loads.

Minimal setup

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

This selects gruber-dark-muted, the default theme. Every built-in variant uses the same neotheme colorscheme command.

What the semantic palette controls

The selected palette supplies colors for:

• Editor surfaces, borders, selections, menus, floats, and sidebars
• Vim syntax groups and Tree-sitter captures
• LSP semantic tokens, references, inlay hints, and diagnostics
• Diff, version-control, markup, search, and navigation states
• All 16 terminal colors plus terminal foreground and background
• Lualine and enabled plugin integrations

This separation lets themes choose a small set of colors while highlight modules assign those colors by purpose. User customization works at the same semantic level.

Project links

• Repository
• Visual theme inventory
• Issue tracker
• License