Theme
Themes
Better Vim comes with 9 hand-picked themes:
Changing the theme
The default theme is Catppuccin. If you want to change the theme, just change the theme.name
on the Better Vim config:
return {
theme = {
name = "dracula"
}
}
Available themes:
catppuccin
dracula
ayu
(and its variants, check here)palenight
tokyonight
nord
onedark
rose-pine
nightfox
(and its variants, check here)
Changing the flavour
Some themes like Catppuccin or Ayu have theme flavours. These flavours can be changed using the flavour key for the respective theme. For example,
if you’re using Catppuccin and want to change the flavour from the default flavour frappe
to latte
you can do this by changing your config to something like:
return {
theme = {
name = "catppuccin",
// Add this line
catppuccin_flavour = "latte"
}
}
Or, if you’re using Ayu, you can change the theme flavour doing something like:
return {
theme = {
name = "ayu",
ayucolor = "light"
}
}
It’s important to notice that each theme has its own flavour key. For example: The flavour key for Catppuccin is catppuccin_flavour
, but for Ayu is ayucolor
. You can see all flavours and flavour keys below.
Available flavours
Each theme has its own flavour key. Here is the complete list of flavours grouped by theme:
-
For
catppuccin
- Flavour key:
catppuccin_flavour
- Flavours:
frappe
,latte
,mocha
andmacchiato
- Flavour key:
-
For
ayu
- Flavour key:
ayu_color
- Flavours:
dark
andlight
- Flavour key:
-
For
rose-pine
- You can use the field
rose_pine
to pass options:
- You can use the field
return {
theme = {
name = "rose-pine",
rose_pine = { variant_dark = "moon" },
},
}
- For
nightfox
- You can use the field
nightfox
to pass options:
- You can use the field
return {
theme = {
name = "nightfox",
nightfox = {
options = {
colorblind = { enable = true },
},
},
},
}
- For all other themes, just change
theme.name
.
Installing custom themes
You can install custom themes using lazy.nvim which is the default plugin manager for Better Vim. Let’s see how to install the Gruvbox theme:
1. Adding it the to the plugins list
Better vim allows you to install custom plugins using the plugins
entry in better-vim.lua
file. A neovim/vim theme is also considered a vim plugin.
You can install the Gruvbox by adding this following code to the plugins
entry in better-vim.lua
file:
Reopen your Neovim and you’ll see that lazy.nvim
is installing the theme automatically.
2. Setting up the theme
Now, open your Better Vim config and change the theme.name
to gruvbox
:
return {
plugins = {
"morhetz/gruvbox",
},
theme = {
name = "gruvbox",
}
}
Now, reopen your neovim and tada 🎉 you should see the new theme applied to your setup.