lume

KO | EN

gitlite — search

#python #typescript #react #flutter #python3 #config #github-config #hacktoberfest #javascript #reactjs #dart #laravel

★ 57 Open GitHub ↗

A muted, elegant dark color theme with warm undertones and a soft lavender identity

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

A muted, elegant dark color theme with warm undertones and a soft lavender identity. 
 Built for Neovim, VS Code, terminals, tmux, and CLI tools.

## Features

- **Single source of truth** — every color lives in `palette.json`, all outputs are generated
- **WCAG AA contrast** — validated at build time, never ships unreadable text
- **15 Neovim plugin integrations** — Telescope, cmp, gitsigns, mini.nvim, noice, trouble, flash, snacks, and more
- **Treesitter + LSP semantic tokens** — full highlighting with 450+ groups
- **13 terminal/CLI targets** — Kitty, Alacritty, WezTerm, Ghostty, iTerm2, foot, Windows Terminal, tmux, fzf, bat, delta, lazygit, OpenCode
- **Transparent mode** — use your terminal's background
- **Configurable italics** — toggle italics for comments and keywords

## Palette

<table>
 <tr>
 <td>
 <img src="https://placehold.co/24x24/b8a0e0/b8a0e0.png" alt="" /> 
 Lavender 
 <code>#b8a0e0</code> 
 keywords, primitives
 </td>
 <td>
 <img src="https://placehold.co/24x24/d0a0b8/d0a0b8.png" alt="" /> 
 Rose 
 <code>#d0a0b8</code> 
 operators, flow
 </td>
 <td>
 <img src="https://placehold.co/24x24/e8b4a0/e8b4a0.png" alt="" /> 
 Peach 
 <code>#e8b4a0</code> 
 types, components
 </td>
 <td>
 <img src="https://placehold.co/24x24/a0d4a8/a0d4a8.png" alt="" /> 
 Sage 
 <code>#a0d4a8</code> 
 strings, additions
 </td>
 </tr>
 <tr>
 <td>
 <img src="https://placehold.co/24x24/8cc0e0/8cc0e0.png" alt="" /> 
 Sky 
 <code>#8cc0e0</code> 
 functions, props
 </td>
 <td>
 <img src="https://placehold.co/24x24/88c0b8/88c0b8.png" alt="" /> 
 Teal 
 <code>#88c0b8</code> 
 tags, escape
 </td>
 <td>
 <img src="https://placehold.co/24x24/c49080/c49080.png" alt="" /> 
 Ember 
 <code>#c49080</code> 
 errors, deletions
 </td>
 <td>
 <img src="https://placehold.co/24x24/c4b080/c4b080.png" alt="" /> 
 Honey 
 <code>#c4b080</code> 
 numbers, warnings
 </td>
 </tr>
</table>

<details>
<summary>Backgrounds &amp; foregrounds</summary>

| Swatch | Name | Hex | Role |
|--------|------|-----|------|
| ![](https://placehold.co/16x16/0a0814/0a0814.png) | Crust | `#0a0814` | Deepest background |
| ![](https://placehold.co/16x16/0e0c18/0e0c18.png) | Mantle | `#0e0c18` | Status bars, borders |
| ![](https://placehold.co/16x16/12101e/12101e.png) | Base | `#12101e` | Editor background |
| ![](https://placehold.co/16x16/1e1a2c/1e1a2c.png) | Surface 0 | `#1e1a2c` | Floats, selections |
| ![](https://placehold.co/16x16/262236/262236.png) | Surface 1 | `#262236` | Active UI elements |
| ![](https://placehold.co/16x16/302c42/302c42.png) | Surface 2 | `#302c42` | Scrollbars, subtle UI |

| Swatch | Name | Hex | Role |
|--------|------|-----|------|
| ![](https://placehold.co/16x16/d8d0e4/d8d0e4.png) | Text | `#d8d0e4` | Primary text |
| ![](https://placehold.co/16x16/b0a8c4/b0a8c4.png) | Subtext | `#b0a8c4` | Secondary text |
| ![](https://placehold.co/16x16/8a8498/8a8498.png) | Overlay | `#8a8498` | UI elements |
| ![](https://placehold.co/16x16/7e7896/7e7896.png) | Comment | `#7e7896` | Comments |

</details>

## Installation

### Neovim

#### lazy.nvim

```lua
{
  "danfry1/lume",
  lazy = false,
  priority = 1000,
  config = function()
    require("lume").setup()
    vim.cmd("colorscheme lume")
  end,
}
```

<details>
<summary>packer.nvim</summary>

```lua
use {
  "danfry1/lume",
  config = function()
    require("lume").setup()
    vim.cmd("colorscheme lume")
  end,
}
```

</details>

#### Options

All options are optional — defaults work out of the box.

```lua
require("lume").setup({
  transparent = false, -- set to true to use your terminal's background
  italics = true,      -- set to false to disable italic comments/keywords
  palette_overrides = { -- override base palette colors before they cascade to all groups
    foregrounds = { text = "#c8c8d8" },   -- softer foreground
    accents = { lavender = "#a890d0" },   -- tweak any accent
  },
  custom_highlights = function(colors, variant)
    -- colors contains: backgrounds, foregrounds, accents, ansi, special
    -- variant is "dark" (or "light" when a light theme is added)
    return {
      Normal = { bg = "#1E1F2E" },
      MiniDiffSignAdd = { fg = colors.accents.sage },
    }
  end,
})
```

`palette_overrides` accepts a table or a function. When a function, it receives the full palette and variant, and should return a table of overrides:

```lua
palette_overrides = function(colors, variant)
  return {
    foregrounds = { text = "#c8c8d8", subtext = "#a0a0b0" },
  }
end,
```

Palette overrides are applied first — all built-in highlight groups and `custom_highlights` will see the modified palette.

#### Plugin support

Highlight groups are included for these plugins (loaded automatically, no config needed):

| Plugin | Plugin | Plugin |
|--------|--------|--------|
| [telescope.nvim](https://github.com/nvim-telescope/telescope.nvim) | [nvim-cmp](https://github.com/hrsh7th/nvim-cmp) | [gitsigns.nvim](https://github.com/lewis6991/gitsigns.nvim) |
| [mini.nvim](https://github.com/echasnovski/mini.nvim) | [noice.nvim](https://github.com/folke/noice.nvim) | [nvim-notify](https://github.com/rcarriga/nvim-notify) |
| [trouble.nvim](https://github.com/folke/trouble.nvim) | [flash.nvim](https://github.com/folke/flash.nvim) | [neo-tree.nvim](https://github.com/nvim-neo-tree/neo-tree.nvim) |
| [oil.nvim](https://github.com/stevearc/oil.nvim) | [lazy.nvim](https://github.com/folke/lazy.nvim) | [which-key.nvim](https://github.com/folke/which-key.nvim) |
| [indent-blankline.nvim](https://github.com/lukas-reineke/indent-blankline.nvim) | [dashboard-nvim](https://github.com/nvimdev/dashboard-nvim) / [alpha-nvim](https://github.com/goolord/alpha-nvim) | [snacks.nvim](https://github.com/folke/snacks.nvim) |

---

### VS Code

[Preview on vscodethemes.com](https://vscodethemes.com/e/DanielFry.lume-color-theme/lume) · Search for **"Lume"** in the Extensions Marketplace, or install from the command line:

```bash
code --install-extension DanielFry.lume-color-theme
```

<details>
<summary>Install from source</summary>

```bash
cd editors/vscode
npx @vscode/vsce package
code --install-extension lume-color-theme-*.vsix
```

</details>

---

### Zed

Search for **"Lume"** in the Zed extension marketplace, or install locally:

```bash
# Copy to Zed's local themes directory
mkdir -p ~/.config/zed/themes
cp editors/zed/themes/lume.json ~/.config/zed/themes/
```

Then select **Lume** from the theme picker (`cmd+k cmd+t`).

---

### Terminals

> **Prefer not to run curl?** You can also clone the repo and copy the files from `terminals/` manually.

<details>
<summary>Kitty</summary>

```bash
curl -o ~/.config/kitty/lume.conf https://raw.githubusercontent.com/danfry1/lume/main/terminals/kitty/lume.conf
```

Then add to `~/.config/kitty/kitty.conf`:

```
include lume.conf
```

</details>

<details>
<summary>Alacritty</summary>

```bash
curl -o ~/.config/alacritty/lume.toml https://raw.githubusercontent.com/danfry1/lume/main/terminals/alacritty/lume.toml
```

Then add to `~/.config/alacritty/alacritty.toml`:

```toml
import = ["~/.config/alacritty/lume.toml"]
```

</details>

<details>
<summary>WezTerm</summary>

```bash
mkdir -p ~/.config/wezterm/colors
curl -o ~/.config/wezterm/colors/lume.toml https://raw.githubusercontent.com/danfry1/lume/main/terminals/wezterm/lume.toml
```

Then set in `~/.config/wezterm/wezterm.lua`:

```lua
config.color_scheme = "Lume"
```

</details>

<details>
<summary>iTerm2</summary>

```bash
curl -o /tmp/lume.itermcolors https://raw.githubusercontent.com/danfry1/lume/main/terminals/iterm2/lume.itermcolors
open /tmp/lume.itermcolors
```

Then go to **iTerm2 → Settings → Profiles → Colors → Color Presets…** and select **Lume**.

</details>

<details>
<summary>Ghostty</summary>

```bash
mkdir -p ~/.config/ghostty/themes
curl -o ~/.config/ghostty/themes/lume https://raw.githubusercontent.com/danfry1/lume/main/terminals/ghostty/lume
```

Then add to `~/.config/ghostty/config`:

```
theme = lume
```

</details>

```bash
curl -o ~/.config/foot/lume.ini https://raw.githubusercontent.com/danfry1/lume/main/terminals/foot/lume.ini
```

Then add to `~/.config/foot/foot.ini`:

```ini
include=~/.config/foot/lume.ini
```

</details>

<details>
<summary>Windows Terminal</summary>

```powershell
curl -o "$env:LOCALAPPDATA\lume.json" https://raw.githubusercontent.com/danfry1/lume/main/terminals/windows-terminal/lume.json
```

Then copy the contents of `lume.json` into the `schemes` array in your Windows Terminal `settings.json`, and set `"colorScheme": "Lume"` on the desired profile.

</details>

---

### Tmux

**Via TPM (recommended)**

```tmux
# ~/.tmux.conf
set -g @plugin 'danfry1/lume'
run '~/.tmux/plugins/tpm/tpm'
```

<details>
<summary>Manual</summary>

```bash
# In ~/.tmux.conf
run-shell /path/to/lume/tmux/lume.tmux
```

</details>

---

### CLI Tools

> **Prefer not to run curl?** You can also clone the repo and copy the files from `cli/` manually.

```bash
curl -o ~/.config/fzf/lume.sh https://raw.githubusercontent.com/danfry1/lume/main/cli/fzf/lume.sh
```

Then source it in your shell rc:

```bash
# ~/.bashrc or ~/.zshrc
source ~/.config/fzf/lume.sh
```

</details>

```bash
curl -o "$(bat --config-dir)/themes/lume.tmTheme" https://raw.githubusercontent.com/danfry1/lume/main/cli/bat/lume.tmTheme
bat cache --build
```

Then set the theme in `~/.config/bat/config`:

```
--theme="Lume"
```

</details>

<details>
<summary>delta</summary>

```bash
curl -s https://raw.githubusercontent.com/danfry1/lume/main/cli/delta/lume.gitconfig >> ~/.gitconfig
```

Then set delta as your Git pager in `~/.gitconfig`:

```ini
[core]
  pager = delta
```

</details>

<details>
<summary>lazygit</summary>

Append the theme to your lazygit config:

```bash
curl -s https://raw.githubusercontent.com/danfry1/lume/main/cli/lazygit/lume.yml >> "$(lazygit --print-config-dir)/config.yml"
```

Or if you prefer, copy the `gui.theme` section from [`cli/lazygit/lume.yml`](cli/lazygit/lume.yml) into your existing `config.yml`.

</details>

<details>
<summary>OpenCode</summary>

```bash
mkdir -p ~/.config/opencode/themes
curl -o ~/.config/opencode/themes/lume.json https://raw.githubusercontent.com/danfry1/lume/main/cli/opencode/lume.json
```

Then select Lume using the `/theme` command in OpenCode, or set it in your `tui.json`:

```json
{
  "theme": "lume"
}
```

</details>

---

## Contributing

`palette.json` is the single source of truth for all colors. All theme files are generated from it.

```bash
bun install          # install dependencies
bun run generate     # regenerate all outputs from palette.json
bun test             # run tests
bun run validate     # check WCAG AA contrast ratios
bun run check        # verify generated files are up to date
bun run typecheck    # typecheck TypeScript
```

Please run `bun run generate` and commit the results before opening a PR.

## License

[MIT](LICENSE)

lume

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README