cafetiere.nvim

Brew your favorite icons with your favorite flavor.

cafetiere blends the catppuccin palette into nvim-web-devicons icons so
they always match your colorscheme.

Screenshots

Left: nvim-web-devicons defaults | Right: catppuccin Mocha and Latte

Dark theme

Light theme

Requirements

Installation

Using lazy.nvim:

{
  "lpnh/cafetiere.nvim",
  dependencies = {
    "catppuccin/nvim",
    "nvim-web-devicons",
  },
  opts = {},
}

Usage

Call setup after your catppuccin and nvim-web-devicons configuration:

require("cafetiere").setup()

The plugin automatically detects your current flavor and updates the icons
accordingly. Even when you change themes.

Customization

You can override the default color mapping by assigning Catppuccin colors to
semantic groups.

Available Options

Semantic Groups: There are 14 color groups you can customize:

grey, red, green, yellow, blue, magenta, cyan
bright_grey, bright_red, bright_green, bright_yellow, bright_blue,
bright_magenta, bright_cyan

Catppuccin Colors: You can use any color from the Catppuccin
palette

Example

require("cafetiere").setup({
  -- Overrides for dark themes (mocha, frappe, macchiato)
  dark = {
    bright_blue = "sky",     -- Use a brighter blue
    bright_magenta = "pink", -- Use pink instead of mauve
  },
  -- Overrides for light theme (latte)
  light = {
    grey = "overlay2", -- Use a darker grey
    yellow = "peach",  -- Use peach instead of yellow
  },
})

Default mappings

dark = {
  grey = "overlay1",
  red = "red",
  green = "green",
  yellow = "peach",
  blue = "blue",
  magenta = "mauve",
  cyan = "teal",
  bright_grey = "text",
  bright_red = "maroon",
  bright_green = "green",
  bright_yellow = "yellow",
  bright_blue = "blue",
  bright_magenta = "mauve",
  bright_cyan = "sapphire",
},

light = {
  grey = "subtext1",
  red = "red",
  green = "green",
  yellow = "yellow",
  blue = "blue",
  magenta = "mauve",
  cyan = "teal",
  bright_grey = "surface0",
  bright_red = "maroon",
  bright_green = "green",
  bright_yellow = "yellow",
  bright_blue = "sky",
  bright_magenta = "pink",
  bright_cyan = "sapphire",
},

How It Works

cafetiere maps nvim-web-devicons' cterm_color numbers to 14 semantic
groups (grey, red, green, yellow, blue, magenta, cyan + bright variants), then
applies your current Catppuccin palette to those groups.

This ensures icons stay visually coherent across all Catppuccin flavors while
preserving their original semantic colors.

Acknowledgments

Catppuccin, for the soothing pastel theme. The
warmest flavors one could ask for.
nvim-web-devicons, for
providing and maintaining the icons we all rely on.

lpnh/cafetiere.nvim