Skip to main content
Call require("Aquavium").setup(opts) before activating the color scheme. You can pass any combination of options — unset keys fall back to their defaults.

​
Default configuration

If you call setup() with no arguments, these defaults apply: 
require("Aquavium").setup({
    bold = true,
    italic = true,
    transparent = true,
})

​
Options

​
bold
boolean
default:"true"
Enable or disable bold text styling. When true, groups such as MatchParen, the selected bufferline buffer, the lualine mode indicator, and plugin-specific groups (e.g., dashboard headers) render in bold.
​
italic
boolean
default:"true"
Enable or disable italic text styling. When true, highlight groups such as comments and special tokens render in italics.
​
transparent
boolean
default:"true"
Enable or disable the transparent background. When true, the background color is set to NONE, allowing your terminal’s configured background (including wallpaper) to show through. When false, the background uses #000e1e.

​
Activating the color scheme

After calling setup(), activate Aquavium with: 
vim.cmd("colorscheme Aquavium")
Alternatively, you can omit the explicit setup() call entirely. When Neovim processes colorscheme Aquavium, it runs colors/Aquavium.lua, which calls require("Aquavium").setup() with all defaults automatically. Only use this approach if you are happy with the default options. Once the color scheme is active, vim.g.colors_name is automatically set to "Aquavium".

​
How options are merged

setup() uses vim.tbl_deep_extend("force", ...) to merge your options into the defaults. This means you only need to specify the values you want to change — any option you omit keeps its default value. 
-- Only disable italic; bold and transparent remain true
require("Aquavium").setup({
    italic = false,
})

​
Disabling all options

To use Aquavium with a solid background and no bold or italic styling: 
require("Aquavium").setup({
    bold = false,
    italic = false,
    transparent = false,
})
vim.cmd("colorscheme Aquavium")
If lualine.nvim is loaded when setup() runs, Aquavium automatically applies its lualine theme by calling lualine.setup() with options.theme = "Aquavium". You do not need to configure lualine separately.

Build docs developers (and LLMs) love

Get started for freeTalk to us