judo.nvim

A personalized, modernized dark theme for Neovim designed for elegance and long coding sessions. Built with an elegant warm palette inspired by the ayu theme, featuring modern blue-gray backgrounds with warm, vibrant syntax colors.

Features

• 🎨 Soothing warm palette - Muted colors optimized for long coding sessions
• ✨ Modern Neovim support - Full LSP semantic tokens, Treesitter, and 0.8+ features
• 🔌 Extensive plugin support - 40+ popular plugins supported out of the box
• 🪶 Lightweight - Pure Lua, no dependencies
• ⚙️ Configurable - Customizable options for your preferences

Installation

Lazy.nvim (recommended)

{
  "kru/judo.nvim",
  lazy = false,
  priority = 1000,
  config = function()
    require("judo").setup({
      -- your configuration comes here
    })
    vim.cmd('colorscheme judo')
  end
}

Packer

use {
  'kru/judo.nvim',
  config = function()
    require('judo').setup()
    vim.cmd('colorscheme judo')
  end
}

Configuration

Defaults

require("judo").setup({
  terminal_colors = true,    -- Enable terminal colors
  undercurl = true,          -- Enable undercurl for diagnostics
  underline = true,          -- Enable underlines
  bold = true,               -- Enable bold text
  italic = {
    strings = true,          -- Italicize strings
    emphasis = true,         -- Italicize emphasis text
    comments = true,         -- Italicize comments
    operators = false,       -- Italicize operators
    folds = true,            -- Italicize folds
  },
  strikethrough = true,      -- Enable strikethrough
  invert_selection = false,  -- Invert visual selection
  invert_signs = false,      -- Invert sign column
  invert_tabline = false,    -- Invert tabline
  inverse = true,            -- Enable inverse colors
  contrast = "",             -- Contrast: "hard", "soft", or "" (default)
  palette_overrides = {},    -- Override palette colors
  overrides = {},            -- Override highlight groups
  dim_inactive = false,      -- Dim inactive windows
  transparent_mode = false,  -- Enable transparent background
})

Example: Custom Overrides

require("judo").setup({
  overrides = {
    -- Customize specific highlight groups
    Comment = { fg = "#888888", italic = true },
    -- Add your own highlight groups
    MyCustomGroup = { fg = "#ff0000", bg = "#00ff00" },
  },
  palette_overrides = {
    -- Customize palette colors
    bg = "#1a1a1a",
    fg = "#e5e5e5",
  },
})

Supported Plugins

UI

• which-key.nvim - Keybinding helper
• noice.nvim - UI enhancements
• nvim-notify - Notifications
• lualine.nvim - Statusline
• bufferline.nvim - Buffer line
• incline.nvim - Floating statuslines
• navic / barbecue - Winbar breadcrumbs
• mini.nvim - Full mini.nvim suite

File Explorers

• neo-tree.nvim - File tree
• nvim-tree.lua - File tree
• oil.nvim - File explorer as buffer
• mini.files - File explorer

Fuzzy Finders

• Telescope - Fuzzy finder
• fzf-lua - Fuzzy finder
• mini.pick - Minimal picker

Git

• gitsigns.nvim - Git signs
• diffview.nvim - Diff viewer
• mini.diff - Minimal diff

Motion & Search

• flash.nvim - Search/jump
• leap.nvim - Motion plugin
• hop.nvim - Motion plugin
• mini.jump - Jump enhancement
• mini.jump2d - 2D jump

LSP & Diagnostics

• trouble.nvim - Diagnostics list
• nvim-lightbulb - Code action indicator
• glance.nvim - LSP references UI
• lspsaga.nvim - LSP UI
• aerial.nvim - Code outline

Editing

• nvim-cmp - Completion
• indent-blankline.nvim - Indent guides
• nvim-ufo - Folding
• illuminate.nvim - Word highlight
• todo-comments.nvim - TODO highlights
• nvim-scrollbar - Scrollbar
• rainbow-delimiters.nvim - Rainbow brackets
• nvim-treesitter-context - Sticky context
• nvim-spectre - Search/replace
• nvim-bqf - Quickfix enhancement

Testing & Tasks

• neotest - Testing framework
• overseer.nvim - Task runner
• coverage.nvim - Code coverage

Markdown & Documentation

• render-markdown.nvim - Markdown rendering
• headlines.nvim - Markdown highlights

Debugging

• nvim-dap - Debug adapter
• nvim-dap-ui - DAP UI

Misc

• lazy.nvim - Plugin manager
• mason.nvim - LSP installer
• dashboard.nvim / alpha.nvim - Startup screen
• harpoon - File marks

Color Palette

Color	Hex	Usage
Background	#212733	Main background (blue-gray)
Background Panel	#272D38	Floating windows, panels
Foreground	#D9D7CE	Main text (warm cream)
Comment	#5C6773	Comments, subtle text
Red	#F07178	Errors, deletes, important
Orange	#FFAE57	Keywords, warnings
Yellow	#FFD57F	Functions, method names
Green	#BBE67E	Strings, success
Cyan	#5CCFE6	Types, tags, info
Blue	#80D4FF	Operators, links
Purple	#D4BFFF	Numbers, constants
Magenta	#FFC44C	Special, accents
Teal	#95E6CB	Hints, regex, escape chars
Border	#3D4751	Borders, separators
Selection	#343F4C	Visual selection
Highlight	#242B38	Cursor line, highlights

Credits

• ayu-theme/ayu-vim - Color palette inspiration
• blazkowolf/gruber-darker-theme
• ellisonleao/gruvbox.nvim

License

MIT