Catppuccin for Neovim

To use custom Lsp Kind Icons and Colors with lspsaga.nvim, use the custom_kind() method from the Catppuccin integration module.

require("lspsaga").setup {
    ui = {
        kind = require("catppuccin.groups.integrations.lsp_saga").custom_kind(),
    },
}

Install Catppuccin using your preferred Neovim plugin manager.

Neovim 0.12+ (vim.pack)

vim.pack.add { { src = "https://github.com/catppuccin/nvim", name = "catppuccin" } }

lazy.nvim

{ "catppuccin/nvim", name = "catppuccin", priority = 1000 }

packer.nvim

use { "catppuccin/nvim", as = "catppuccin" }

rocks.nvim

:Rocks install catppuccin.nvim

Catppuccin provides two presets for reactive.nvim: cursor and cursorline. You can load them for any flavor (e.g., catppuccin-mocha-cursor).

require('reactive').setup {
  load = { 'catppuccin-mocha-cursor', 'catppuccin-mocha-cursorline' }
}

After installation, apply the colorscheme using Vimscript or Lua.

Vimscript

colorscheme catppuccin-nvim " Available flavours: catppuccin-latte, catppuccin-frappe, catppuccin-macchiato, catppuccin-mocha

Lua

vim.cmd.colorscheme "catppuccin-nvim"

To use Catppuccin with barbecue.nvim, enable the integration in Catppuccin and then set the theme in your barbecue configuration using one of the Catppuccin flavors (catppuccin-latte, catppuccin-frappe, catppuccin-macchiato, or catppuccin-mocha).

-- Catppuccin setup
require("catppuccin").setup({
    integrations = {
        barbecue = {
            dim_dirname = true,
            bold_basename = true,
            dim_context = false,
            alt_background = false,
        },
    }
})

-- Barbecue setup
require("barbecue").setup {
  theme = "catppuccin-nvim",
}

To use Catppuccin with blink.pairs, enable the integration and configure the highlight groups in the blink.pairs setup.

-- Catppuccin setup
require("catppuccin").setup({
    integrations = {
        blink_pairs = true,
    }
})

-- Blink.pairs setup
require("blink.pairs").setup {
    highlights = {
        groups = {
            "BlinkPairsRed",
            "BlinkPairsYellow",
            "BlinkPairsBlue",
            "BlinkPairsOrange",
            "BlinkPairsGreen",
            "BlinkPairsPurple",
            "BlinkPairsCyan",
        },
    },
}

Vim support is provided via the vim branch. Note that Vim support is being phased out; for full support, use catppuccin/vim.

vim-plug

Plug 'catppuccin/nvim', { 'branch': 'vim', 'as': 'catppuccin' }

To use Catppuccin with feline.nvim, use the catppuccin.special.feline module.

Note: Feline does not officially support custom themes. To ensure :colorscheme catppuccin-<flavour> works, use the following autocmd workaround:

-- Workaround for theme switching
vim.api.nvim_create_autocmd("ColorScheme", {
    pattern = "*",
    callback = function()
        package.loaded["feline"] = nil
        package.loaded["catppuccin.special.feline"] = nil
        require("feline").setup {
            components = require("catppuccin.special.feline").get_statusline(),
        }
    end,
})

-- Basic setup
local ctp_feline = require('catppuccin.special.feline')
ctp_feline.setup()
require("feline").setup({
    components = ctp_feline.get_statusline(),
})

When using fidget.nvim, set notification.window.winblend to 0 to ensure compatibility.

require("fidget").setup {
    notification = {
        window = {
            winblend = 0,
        },
    }
}

Catppuccin provides advanced integration for lualine.nvim, allowing you to override colors per flavor or per mode. You can use a function that consumes the current palette to create dynamic overrides.

-- In your catppuccin config
require("catppuccin").setup({
    integrations = {
        lualine = {
            all = function(colors) -- Applies to all flavors
                return {
                    normal = {
                        a = { bg = colors.lavender, gui = "italic" },
                        b = { fg = colors.lavender },
                    }
                }
            end,
            macchiato = {
                normal = {
                    a = { bg = "#abcdef" },
                }
            },
        },
    }
})

-- In your lualine config
require('lualine').setup {
    options = {
        theme = "catppuccin-nvim"
    }
}