{"id":22211679,"url":"https://github.com/cdmill/neomodern.nvim","last_synced_at":"2025-07-27T11:32:36.034Z","repository":{"id":218133236,"uuid":"745660033","full_name":"cdmill/neomodern.nvim","owner":"cdmill","description":"A collection of modern themes for Neovim","archived":false,"fork":false,"pushed_at":"2024-05-22T04:57:45.000Z","size":3700,"stargazers_count":20,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-05-22T21:48:01.724Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cdmill.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-01-19T20:17:53.000Z","updated_at":"2024-05-30T18:20:57.483Z","dependencies_parsed_at":"2024-02-11T07:22:50.684Z","dependency_job_id":"7cfcd464-da17-47cd-abdd-7f6d97ddedc9","html_url":"https://github.com/cdmill/neomodern.nvim","commit_stats":null,"previous_names":["cdmill/saguaro.nvim","cdmill/neomodern.nvim"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdmill%2Fneomodern.nvim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdmill%2Fneomodern.nvim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdmill%2Fneomodern.nvim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cdmill%2Fneomodern.nvim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cdmill","download_url":"https://codeload.github.com/cdmill/neomodern.nvim/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227801518,"owners_count":17822032,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-02T20:36:15.883Z","updated_at":"2025-07-27T11:32:36.018Z","avatar_url":"https://github.com/cdmill.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# \u003cp align=\"center\"\u003e *NEOMODERN*.nvim \u003c/p\u003e\r\n\r\n\u003cp align=\"center\"\u003e\r\nmodern — simple — unintrusive\r\n\u003c/p\u003e\r\n\r\n\u003cp align=\"center\"\u003e\r\n\u003cimg src=\"https://img.shields.io/github/v/tag/cdmill/neomodern.nvim?style=flat\u0026label=RELEASE\u0026labelColor=%23212123\u0026color=%238a88db\" /\u003e\r\n\u003cimg src=\"https://img.shields.io/badge/BUILT_WITH_LUA-blue?style=flat\u0026color=%23629da3\" /\u003e\r\n\u003cimg src=\"https://img.shields.io/badge/NEOVIM-0.9-blue?style=flat\u0026logo=Neovim\u0026labelColor=%23212123\u0026color=%238a88db\" /\u003e\r\n\u003c/p\u003e\r\n\r\n\u003e [!NOTE]\r\n\u003e With the release of `v1`, support was dropped for COFFEECAT, DARKFOREST, and DAYLIGHT.\r\n\u003e See [Legacy Support](#legacy-support) for details.\r\n\r\n## Table of Contents\r\n\r\n- 📷 [Gallery](#gallery)\r\n- 🛠 [Installation](#installation)\r\n- ⚙️ [Configuration](#configuration)\r\n- 🎨 [Customization](#customization)\r\n- 🔌 [Supported Plugins](#supported-plugins)\r\n- 🆓 [Extras](#extras)\r\n- 📌 [Legacy Support](#legacy-support)\r\n- 🪄 [Contributing](#contributing)\r\n- 💫 [Inspiration](inspiration)\r\n\r\n## Gallery\r\n\r\n### ❄️ *ICECLIMBER*\r\n\r\nA theme with colors inspired from Nintendo's Ice Climbers characters\r\n\r\n\u003cdetails open\u003e\r\n\u003csummary\u003eDark Variant\u003c/summary\u003e\r\n\r\n![image](https://github.com/cdmill/neomodern.nvim/blob/assets/iceclimber-dark.png)\r\n\r\n\u003c/details\u003e\r\n\r\n\u003cdetails closed\u003e\r\n\u003csummary\u003eLight Variant\u003c/summary\u003e\r\n\r\n![image](https://github.com/cdmill/neomodern.nvim/blob/assets/iceclimber-light.png)\r\n\r\n\u003c/details\u003e\r\n\r\n### 🌱 *GYOKURO*\r\n\r\nA fresh green tea inspired theme\r\n\r\n\u003cdetails open\u003e\r\n\u003csummary\u003eDark Variant\u003c/summary\u003e\r\n\r\n![image](https://github.com/cdmill/neomodern.nvim/blob/assets/gyokuro-dark.png)\r\n\r\n\u003c/details\u003e\r\n\r\n\u003cdetails closed\u003e\r\n\u003csummary\u003eLight Variant\u003c/summary\u003e\r\n\r\n![image](https://github.com/cdmill/neomodern.nvim/blob/assets/gyokuro-light.png)\r\n\r\n\u003c/details\u003e\r\n\r\n### 🍂 *HOJICHA*\r\n\r\nA roasted green tea inspired theme\r\n\r\n\u003cdetails open\u003e\r\n\u003csummary\u003eDark Variant\u003c/summary\u003e\r\n\r\n![image](https://github.com/cdmill/neomodern.nvim/blob/assets/hojicha-dark.png)\r\n\r\n\u003c/details\u003e\r\n\r\n\u003cdetails closed\u003e\r\n\u003csummary\u003eLight Variant\u003c/summary\u003e\r\n\r\n![image](https://github.com/cdmill/neomodern.nvim/blob/assets/hojicha-light.png)\r\n\r\n\u003c/details\u003e\r\n\r\n### 🌷 *ROSEPRIME*\r\n\r\nInspired by [ThePrimeagen's](https://github.com/ThePrimeagen) use of the [Rosé-Pine](https://github.com/rose-pine/neovim) theme\r\n\r\n\u003cdetails open\u003e\r\n\u003csummary\u003eDark Variant\u003c/summary\u003e\r\n\r\n![image](https://github.com/cdmill/neomodern.nvim/blob/assets/roseprime-dark.png)\r\n\r\n\u003c/details\u003e\r\n\r\n\u003cdetails closed\u003e\r\n\u003csummary\u003eLight Variant\u003c/summary\u003e\r\n\r\n![image](https://github.com/cdmill/neomodern.nvim/blob/assets/roseprime-light.png)\r\n\r\n\u003c/details\u003e\r\n\r\n## Installation\r\n\r\nInstall via your favorite package manager:\r\n\r\n```lua\r\n-- Using lazy.nvim\r\n{\r\n  \"cdmill/neomodern.nvim\",\r\n  lazy = false,\r\n  priority = 1000,\r\n  config = function()\r\n    require(\"neomodern\").setup({\r\n      -- optional configuration here\r\n    })\r\n    require(\"neomodern\").load()\r\n  end,\r\n},\r\n```\r\n\r\n## Configuration\r\n\r\nThere are 4 themes included, each with a light and dark variant.\r\nThe light theme is used when `{ variant = \"light\" }` is passed to `setup(options)` or\r\nwhen `vim.o.background = \"light\"`.\r\n\r\nDefault options are given below:\r\n\r\n```lua\r\nrequire(\"neomodern\").setup({\r\n  -----MAIN OPTIONS-----\r\n  --\r\n  -- Can be one of: 'iceclimber' | 'gyokuro' | 'hojicha' | 'roseprime'\r\n  theme = \"iceclimber\",\r\n  -- Can be one of: 'light' | 'dark', or set via vim.o.background\r\n  variant = \"dark\",\r\n  -- Use an alternate, darker bg\r\n  alt_bg = false,\r\n  -- If true, docstrings will be highlighted like strings, otherwise they will be\r\n  -- highlighted like comments. Note, behavior is dependent on the language server.\r\n  colored_docstrings = true,\r\n  -- If true, highlights the {sign,fold} column the same as cursorline\r\n  cursorline_gutter = true,\r\n  -- If true, highlights the gutter darker than the bg\r\n  dark_gutter = false,\r\n  -- if true favor treesitter highlights over semantic highlights\r\n  favor_treesitter_hl = false,\r\n  -- Don't set background of floating windows. Recommended for when using floating\r\n  -- windows with borders.\r\n  plain_float = false,\r\n  -- Show the end-of-buffer character\r\n  show_eob = true,\r\n  -- If true, enable the vim terminal colors\r\n  term_colors = true,\r\n  -- Keymap (in normal mode) to toggle between light and dark variants.\r\n  toggle_variant_key = nil,\r\n  -- Don't set background\r\n  transparent = false,\r\n\r\n  -----DIAGNOSTICS and CODE STYLE-----\r\n  --\r\n  diagnostics = {\r\n    darker = true, -- Darker colors for diagnostic\r\n    undercurl = true, -- Use undercurl for diagnostics\r\n    background = true, -- Use background color for virtual text\r\n  },\r\n  -- The following table accepts values the same as the `gui` option for normal\r\n  -- highlights. For example, `bold`, `italic`, `underline`, `none`.\r\n  code_style = {\r\n    comments = \"italic\",\r\n    conditionals = \"none\",\r\n    functions = \"none\",\r\n    keywords = \"none\",\r\n    headings = \"bold\", -- Markdown headings\r\n    operators = \"none\",\r\n    keyword_return = \"none\",\r\n    strings = \"none\",\r\n    variables = \"none\",\r\n  },\r\n\r\n  -----PLUGINS-----\r\n  --\r\n  -- The following options allow for more control over some plugin appearances.\r\n  plugin = {\r\n    lualine = {\r\n      -- Bold lualine_a sections\r\n      bold = true,\r\n      -- Don't set section/component backgrounds. Recommended to not set\r\n      -- section/component separators.\r\n      plain = false,\r\n    },\r\n    cmp = { -- works for nvim.cmp and blink.nvim\r\n      -- Don't highlight lsp-kind items. Only the current selection will be highlighted.\r\n      plain = false,\r\n      -- Reverse lsp-kind items' highlights in blink/cmp menu.\r\n      reverse = false,\r\n    },\r\n  },\r\n\r\n  -- CUSTOM HIGHLIGHTS --\r\n  --\r\n  -- Override default colors\r\n  colors = {},\r\n  -- Override highlight groups\r\n  highlights = {},\r\n})\r\n-- Convenience function that simply calls `:colorscheme \u003ctheme\u003e` with the theme\r\n-- specified in your config.\r\nrequire(\"neomodern\").load()\r\n```\r\n\r\n## Customization\r\n\r\nExample using custom colors and highlights:\r\n\r\n```lua\r\nrequire(\"neomodern\").setup {\r\n  colors = {\r\n    orange = '#ff8800', -- define a new color\r\n    keyword = '#817faf', -- redefine an existing color\r\n  },\r\n  highlights = {\r\n    ...\r\n    [\"@keyword\"] = { fg = \"$keyword\", fmt = 'bold' },\r\n    [\"@function\"] = { bg = \"$orange\", fmt = 'underline,italic' },\r\n    ...\r\n  },\r\n}\r\n```\r\n\r\nSee `neomodern.palette` for color names.\r\n\r\n## Supported Plugins\r\n\r\n- [Dashboard](https://github.com/nvimdev/dashboard-nvim)\r\n- [cmp](https://github.com/hrsh7th/nvim-cmp)\r\n- [Diffview](https://github.com/sindrets/diffview.nvim)\r\n- [Gitsigns](https://github.com/lewis6991/gitsigns.nvim)\r\n- [Telescope](https://github.com/nvim-telescope/telescope.nvim)\r\n- [Neo-tree](https://github.com/nvim-neo-tree/neo-tree.nvim)\r\n- [Nvim-tree](https://github.com/nvim-tree/nvim-tree.lua)\r\n- plus more\r\n\r\n## Extras\r\n\r\nAvailable [here](https://github.com/cdmill/neomodern.nvim/tree/main/extras)\r\n\r\n- [Alacritty](https://github.com/alacritty/alacritty)\r\n- [Foot](https://codeberg.org/dnkl/foot)\r\n- [FZF](https://github.com/junegunn/fzf)\r\n- [kitty](https://github.com/kovidgoyal/kitty)\r\n- [fish](https://github.com/fish-shell/fish-shell)\r\n- [wezterm](https://github.com/wez/wezterm)\r\n- [Windows Terminal](https://github.com/microsoft/terminal)\r\n- [Iterm2](https://iterm2.com)\r\n\r\n## Legacy Support\r\n\r\nWith the release of `v1`, Neomodern dropped support for the legacy themes COFFEECAT,\r\nDARKFOREST, and DAYLIGHT. If you would still like to use these themes, you can use the\r\nfollowing commit:\r\n\r\n```lua\r\n{\r\n    \"cdmill/neomodern.nvim\",\r\n    commit = \"8eecbe1\",\r\n    opts = {\r\n        -- your settings here\r\n    }\r\n}\r\n```\r\n\r\n## Contributing\r\n\r\nPull requests are welcome.\r\n\r\nIf you are wanting support for a plugin, either open an issue or submit a pull request\r\nwith your highlight additions in [this file](https://github.com/cdmill/neomodern.nvim/blob/main/lua/neomodern/highlights/plugin.lua).\r\n\r\n## Inspiration\r\n\r\n- [OneDark.nvim](https://github.com/navarasu/onedark.nvim)\r\n- [Bamboo.nvim](https://github.com/ribru17/bamboo.nvim)\r\n- [Catppuccin](https://github.com/catppuccin/nvim)\r\n- [Everforest](https://github.com/sainnhe/everforest)\r\n- [Rosé-Pine](https://github.com/rose-pine/neovim)\r\n- [TokyoNight](https://github.com/folke/tokyonight.nvim)\r\n- [No Clown Fiesta](https://github.com/aktersnurra/no-clown-fiesta.nvim)\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcdmill%2Fneomodern.nvim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcdmill%2Fneomodern.nvim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcdmill%2Fneomodern.nvim/lists"}