Skip to main content

​
Prerequisites

  • Neovim 0.11+ — required
  • nvim-treesitter — optional, for richer syntax highlighting

​
Install Aquavium.nvim

1

Configure your terminal

Aquavium.nvim is designed to run on a transparent terminal background. Before installing the plugin, set your terminal’s background color and opacity.
The recommended settings are a black background (#000000) at 70% opacity. These values give you enough depth to distinguish UI elements while letting your wallpaper show through.
If you use WezTerm, add the following to your wezterm.lua:
wezterm.lua
-- Set background color
config.window_background_gradient = { colors = { '#000000' } } -- or another color

-- Set opacity
config.window_background_opacity = 0.7
Other terminals that support background opacity (Kitty, Alacritty, Ghostty, etc.) work with Aquavium.nvim too — configure the background color and opacity using your terminal’s own settings.
2

Add the plugin with lazy.nvim

Add Aquavium.nvim to your lazy.nvim plugin list. Set lazy = false and priority = 1000 so the color scheme loads before other plugins.
init.lua
{
    "T-b-t-nchos/Aquavium.nvim",
    lazy = false,
    priority = 1000,
    config = function()
        local aquavium = require("Aquavium")
        aquavium.setup({
            -- options
        })
        vim.cmd("colorscheme Aquavium")
    end,
},
3

Sync plugins

Open Neovim and run:
:Lazy sync
Lazy.nvim will download and install Aquavium.nvim, then call your config function to apply the color scheme.

​
Verify the installation

After syncing, your Neovim should display the Aquavium color scheme. You can confirm it is active by running: 
:echo g:colors_name
The output should be Aquavium.

​
Next steps

Configuration

Learn about the available options to customize bold, italic, and transparency settings.

Build docs developers (and LLMs) love

Get started for freeTalk to us