📈 GH Trending Explorer 🎲 Surprise me

← all repos

catppuccin / nvim

git clone https://github.com/catppuccin/nvim.git v2.0.0 · 6mo ago 🔥 on GitHub Trending today

🍨 Soothing pastel theme for Neovim

+1
stars, 24h · #537
—
stars, 7 days
—
stars, 30 days
7.7k
★ total
338
forks · 12 open issues

Star history starts 2026-10-20; the chart appears after the second daily snapshot.

LanguageLua
LicenseMIT
Created2021-08-18 (5y ago)
Last push4d ago
Watchers21
OwnerOrganization

Seen on GitHub Trending

  • 2026-10-20 — #12 daily in lua · +1 ★

GitHub topics

Links

README excerpt
Catppuccin for Neovim 
This port of Catppuccin is special because it was the first one and the one that originated the project itself. Given this, it's important to acknowledge that it all didn't come to be what it is now out of nowhere. So, if you are interested in knowing more about the initial stages of the theme, you can find it under the v0.1 tag.
## Previews
 🌻 Latte 
 🪴 Frappé 
 🌺 Macchiato 
 🌿 Mocha 
## Features
- Supports Neovim >= 0.8
- Highly configurable with 4 different flavours and the ability to create your own!
- Compiled configuration for fast startup time
- Integrations with lsp, treesitter and a bunch of plugins
- Support for many other applications
## Installation
with Neovim 0.12's `vim.pack`
 [code] 
lazy.nvim
 [code] 
packer.nvim
 [code] 
rocks.nvim
 [code] 
### Vim support
Support for Vim is provided through the `vim` branch.
vim-plug
 [code] 
> [!NOTE]
> Keep in mind that Vim support has been dropped
> (#949) and this branch won't
> receive further updates unless necessary. For full Vim support, see
> catppuccin/vim. Starting from Vim
> v9.2.0219 and Neovim 0.12, `catppuccin` is shipped with the editors. Note that
> it is not maintained by the Catppuccin organization and follows
> Vim colorscheme rules
> instead of
> the official Catppuccin style guide.
## Usage
 [code] 
 [code] 
## Configuration
There is no need to call `setup` if you don't want to change the default options and settings.
 [code] 
## Customization
### Getting colors
 [code] 
Returns a table where the key is the name of the color and the value is the hex code.
### Overwriting colors
Colors can be overwritten using `color_overrides`, see https://github.com/catppuccin/nvim/discussions/323 for inspiration:
 [code] 
### Overwriting highlight groups
Global highlight groups can be overwritten, for example:
 [code] 
Highlight groups per flavour can also be overwritten, for example:
 [code] 
## Integrations
Catppuccin provides theme support for other plugins in the Neovim ecosystem and extended Neovim functionality through _integrations_.
To enable/disable an integration you just need to set it to true/false, for example:
 [code] 
If you use `vim.pack`, lazy.nvim or
pckr.nvim to manage your plugins, you
can use the `auto_integrations` option to let catppuccin automatically detect
installed plugins and enable their respective integrations (this option is
enabled by default).
 [code] 
Below is a list of supported plugins and their corresponding integration module.
> [!Important]
> If you'd like to see the full list of highlight groups modified by Catppuccin, see the `lua/catppuccin/groups/integrations/` directory.
 Plugin Default 
 aerial.nvim 
 [code] 
 alpha-nvim 
 [code] 
 artio.nvim 
 [code] 
 barbar.nvim 
 [code] 
 barbecue.nvim 
 [code] 
 Special 
Use this to set it up:
 [code] 
 beacon.nvim 
 [code] 
 blink.cmp 
 [code] 
 blink.indent 
 [code] 
 blink.pairs 
 [code] 
 Special 
Use this to set it up:
 [code] 
 bufferline.nvim 
 Special 
Update your bufferline