explaingit

catppuccin/nvim

★ 7,430LuaAudience · developerComplexity · 2/5Setup · easy

TLDR

A Neovim color scheme plugin with four warm pastel flavors that loads in about one millisecond and includes built-in support for popular Neovim plugins out of the box.

Mindmap

mindmap
  root((catppuccin nvim))
  What it does
    Color scheme plugin
    Four flavor variants
    Auto dark mode switch
  Tech stack
    Lua
    Neovim
  Features
    Plugin integrations
    Custom highlights
    1ms load time
  Setup
    lazy.nvim
    packer.nvim
    rocks.nvim
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Switch your Neovim editor to a warm pastel color scheme in one of four flavors from light to dark

USE CASE 2

Auto-switch between light and dark theme variants based on your system's dark mode setting

USE CASE 3

Override individual highlight colors or groups to match your personal taste

Tech stack

LuaNeovim

Getting it running

Difficulty · easy Time to first run · 30min

Requires a working Neovim installation and a plugin manager such as lazy.nvim or packer.nvim.

In plain English

Catppuccin for Neovim is a color scheme plugin for the Neovim text editor, built around a palette of warm pastel tones. Neovim is a terminal-based code editor popular among developers who want fast, keyboard-driven editing. A color scheme controls the colors used for text highlighting, the editor background, the status bar, and other visual elements. This repository is notable because it was the first port of the Catppuccin palette to any editor, and the project grew into a broader family of color schemes from there. The theme comes in four variations called flavors: Latte is a light variant, and Frappe, Macchiato, and Mocha are progressively darker. You can switch between them or configure Neovim to automatically pick one based on whether your system is in light or dark mode. The configuration is compiled to a cached format, which the README says allows the theme to load in roughly one millisecond on startup. Beyond the basic color palette, the plugin has built-in support for many popular Neovim plugins, including treesitter (used for syntax highlighting), LSP (used for showing inline code errors and hints), and several file management and completion plugins. You can also override individual colors or define custom highlight groups if the defaults do not match your preferences. Installation is handled through whichever Neovim plugin manager you use. The README includes setup snippets for lazy.nvim, packer.nvim, rocks.nvim, and Neovim 0.12 built-in package support. A separate Vim branch exists but is no longer receiving active updates according to the README. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Set up catppuccin/nvim with lazy.nvim to use the Mocha dark flavor and enable treesitter and LSP integrations
Prompt 2
Configure catppuccin/nvim to automatically switch between Latte light and Mocha dark based on my system dark mode setting
Prompt 3
Show me how to override specific highlight groups in catppuccin/nvim to change how comments look
Prompt 4
Install catppuccin/nvim with packer.nvim and enable built-in support for file management plugins
Open on GitHub → Explain another repo

← catppuccin on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.