fathom.nvim

A deep ocean dark colorscheme for Neovim. Rich blues and purple accents inspired by the depths of the abyss.

Features

Installation

lazy.nvim

{
  "josstei/fathom.nvim",
  lazy = false,
  priority = 1000,
  config = function()
    require("fathom").setup()
    vim.cmd.colorscheme("fathom")
  end,
}

use {
  "josstei/fathom.nvim",
  config = function()
    require("fathom").setup()
    vim.cmd.colorscheme("fathom")
  end
}

Plug 'josstei/fathom.nvim'

require("fathom").setup()
vim.cmd.colorscheme("fathom")

Configuration

All options with their defaults:

require("fathom").setup({
  palette = "fathom",
  transparent = false,
  dim_inactive = false,
  styles = {
    comments = { italic = true },
    keywords = { bold = true },
    functions = { bold = true },
    variables = {},
    types = {},
    strings = {},
  },
  integrations = {
    treesitter = true,
    lsp = true,
  },
  on_highlights = nil,
})

Syntax Styles

The styles table controls font attributes per syntax category. Each accepts any combination of bold, italic, underline, undercurl, and strikethrough.

Palette

	Color	Hex	Usage
	Background	#050A14	Editor background
	Foreground	#C8C8E0	Primary text
	Blue	#5E81F4	Functions, cursor
	Purple	#7C3AED	Keywords, booleans
	Cyan	#56B6C2	Numbers, specials
	Teal	#4A9A9A	Strings, characters
	Magenta	#9D7CD8	Types, macros
	Green	#7EC49E	Git additions
	Red	#E05070	Errors, git deletions
	Yellow	#D4A656	Warnings
	Orange	#C87040	Terminal color, extension point
	Pink	#B48EAD	Terminal color, extension point

Plugin Support

All plugins are applied unconditionally. Missing plugins are safely skipped at runtime.

Lualine

Fathom auto-applies a mode-aware lualine theme when the colorscheme loads. No configuration needed.

The theme respects your transparent setting. To configure lualine manually instead:

require("lualine").setup({
  options = { theme = "fathom" },
})

Customization

Highlight Overrides

The on_highlights callback runs last in the highlight chain, giving you full control over any group:

require("fathom").setup({
  on_highlights = function(colors, config)
    return {
      ["@comment.todo"] = { fg = colors.palette.yellow, bold = true },
    }
  end,
})

The colors argument exposes both colors.palette (raw hex values) and colors.semantic (named roles like keyword, func, type).

Custom Plugin Highlights

Register highlights for plugins not covered by the built-in set. Registrations made after the theme loads are applied immediately.

require("fathom").register_plugin("my_plugin", function(colors, config)
  return {
    MyPluginNormal = { fg = colors.palette.teal, bg = colors.palette.bg_alt },
    MyPluginBorder = { fg = colors.semantic.border },
  }
end)

Custom Palettes

Create lua/fathom/palettes/<name>.lua returning a module with palette and semantic tables. The loader validates all required keys at load time.

return {
  name = "my_palette",
  palette = {
    bg = "#050A14",
    fg = "#C8C8E0",
    -- 20 required keys total, see lua/fathom/palettes/fathom.lua
  },
  semantic = {
    bg = "#050A14",
    fg = "#C8C8E0",
    keyword = "#7C3AED",
    -- 46 required keys total, see lua/fathom/palettes/fathom.lua
  },
}

Then activate it:

require("fathom").setup({ palette = "my_palette" })

Color Utilities

Helper functions available via require("fathom.utils") for use in on_highlights callbacks or custom palettes:

API Reference

License

MIT