Overtones

A minimal Neovim colorscheme built with HSL color manipulation, featuring two main colors: a golden yellow (hsl(40, 100%, 50%)) and a cyan highlight (hsl(160, 100%, 50%)) on a dark charcoal background.

Features

• HSL-based color system for consistent brightness variations
• Minimal color palette using only two main colors
• Dark theme with charcoal background
• Telescope integration with custom highlights
• TreeSitter support with semantic highlighting
• LSP diagnostics support

Installation

LazyVim

{
  "ericdwhite/overtones.nvim",
  lazy = false,
  priority = 1000,
  config = function()
    vim.cmd([[colorscheme overtones]])
  end,
}

Packer

use {
  "ericdwhite/overtones.nvim",
  config = function()
    vim.cmd([[colorscheme overtones]])
  end
}

vim-plug

Plug 'your-username/overtones.nvim'

Local Development

For local development and testing:

LazyVim (Local)

{
  dir = "~/path/to/overtones",  -- Path to your local overtones directory
  name = "overtones.nvim",
  lazy = false,
  priority = 1000,
  config = function()
    vim.cmd([[colorscheme overtones]])
  end,
}

Packer (Local)

use {
  "~/path/to/overtones",  -- Path to your local overtones directory
  config = function()
    vim.cmd([[colorscheme overtones]])
  end
}

Manual Setup

Add the theme directory to your Neovim runtime path:

-- In your init.lua
vim.opt.runtimepath:append("~/path/to/overtones")
vim.cmd([[colorscheme overtones]])

Then in your init.vim or init.lua:

colorscheme overtones

Usage

Basic Usage

vim.cmd([[colorscheme overtones]])

With Configuration

require("overtones").setup({
  -- Configuration options will be added in future versions
})

Color Palette

• Background: #1a1a1a (dark charcoal)
• Main Color: hsl(40, 100%, 50%) (golden yellow) with brightness variations
• Highlight Color: hsl(160, 100%, 50%) (cyan-green) used sparingly
• Foreground: Variations of the main color at different brightness levels

Supported Plugins

• Telescope: Custom highlights for better integration
• TreeSitter: Full semantic highlighting support
• LSP: Diagnostic and reference highlighting
• Git: Diff highlighting support

Development

The theme is structured as follows:

overtones/
├── colors/overtones.lua      # Main colorscheme entry point
├── lua/overtones/
│   ├── init.lua             # Theme initialization
│   ├── colors.lua           # HSL color utilities and palette
│   ├── highlights.lua       # Base Neovim highlight groups
│   └── telescope.lua        # Telescope-specific highlights
└── plugin/overtones.lua     # Plugin setup