Paragon

A refined dark theme for Neovim, designed for semantic clarity and long, distraction-free coding sessions.

Preview

Features

• 30+ Cross-Tool Ports – Terminals, editors, and CLI tools.
• 30+ Plugin Integrations – Native support for major Neovim plugins.
• Semantic & Balanced Design – Purposeful highlights with refined contrast for long sessions.
• Flexible Customization – Transparency, dimming, borders, and syntax styling.

Ports

Tool	Extra
Alacritty	extra/alacritty
bat	extra/bat
btop	extra/btop
delta	extra/delta
dunst	extra/dunst
eza	extra/eza
Fish	extra/fish
Foot	extra/foot
fzf	extra/fzf
Ghostty	extra/ghostty
GNOME Terminal	extra/gnome-terminal
Helix	extra/helix
iTerm	extra/iterm
Kitty	extra/kitty
Konsole	extra/konsole
lazygit	extra/lazygit
Obsidian	extra/obsidian
opencode	extra/opencode
rofi	extra/rofi
st	extra/st
Starship	extra/starship
Terminator	extra/terminator
Tmux	extra/tmux
Vim	extra/vim
VS Code	extra/vscode
Warp	extra/warp
Waybar	extra/waybar
WezTerm	extra/wezterm
Windows Terminal	extra/windows-terminal
XFCE Terminal	extra/xfce-terminal
Yazi	extra/yazi
Zellij	extra/zellij

Supported Plugins

Plugin	Source
aerial.nvim	aerial
barbar.nvim	barbar
blink.cmp	blink
bufferline.nvim	bufferline
nvim-cmp	cmp
diffview.nvim	diffview
dashboard-nvim	dashboard
flash.nvim	flash
fzf-lua	fzf
vim-gitgutter	gitgutter
gitsigns.nvim	gitsigns
glyph-palette.vim	glyph-palette
grug-far.nvim	grug-far
headlines.nvim	headlines
hop.nvim	hop
indentmini.nvim	indentmini
lazy.nvim	lazy
leap.nvim	leap
lspsaga.nvim	lspsaga
mini.icons	mini_icons
mini.pick	mini_pick
neo-tree.nvim	neo-tree
neogit	neogit
neotest	neotest
noice.nvim	noice
nvim-notify	notify
nvim-tree.lua	nvim-tree
render-markdown.nvim	render-markdown
snacks.nvim	snacks
vim-sneak	sneak
telescope.nvim	telescope
trouble.nvim	trouble
which-key.nvim	which-key

Installation

lazy.nvim

{
  "nnavales/paragon.nvim",
  lazy = false,
  priority = 1000,
  opts = {},
}

packer.nvim

use { "nnavales/paragon.nvim" }

Usage

-- Load the colorscheme
vim.cmd.colorscheme("paragon")

Plugin specific configs (lualine, cmp)

lualine.nvim

require('lualine').setup {
  options = {
    theme = 'paragon' -- or paragon_transparent (way cleaner)
  }
}

nvim-cmp

-- on your cmp configuration
window = {
    completion = cmp.config.window.bordered({
        border = "", -- "", "rounded", "single"
        winhighlight = "Normal:NormalFloat,FloatBorder:FloatBorder,CursorLine:PmenuSel,Search:None",
    }),
    documentation = cmp.config.window.bordered({
        border = "single",
        winhighlight = "Normal:NormalFloat,FloatBorder:FloatBorder,Search:None",
    }),
},

Configuration

Paragon provides defaults but allows customization:

require("paragon").setup({
  transparent = false,                -- Disable background color (use terminal background)
  dim = true,                         -- Dim inactive windows
  borders = true,                     -- Show borders around floating windows and popups
  styles = {                          -- Syntax element styles
    keywords = {},                    -- if, for, return, break, continue
    functions = {},                   -- foo(), bar(), method calls
    types = {},                       -- class, struct, int, enum
    comments = { italic = false },    -- Line and block comments
    builtins = { italic = true },     -- print(), self, true, false, nil
  },
  terminal_colors = true,             -- Terminal colors when using :terminal
  plugins = {},                       -- Plugin highlight overrides (e.g., telescope = false to disable)
})

Requirements

• Neovim >= 0.9
• termguicolors enabled

Thanks to

This theme is heavily inspired by tokyonight.nvim by @folke. The architecture, design patterns, and plugin system served as an excellent foundation for Paragon.

License

MIT