{"id":13411817,"url":"https://github.com/lmburns/kimbox","last_synced_at":"2025-03-14T17:31:09.333Z","repository":{"id":38825479,"uuid":"337952402","full_name":"lmburns/kimbox","owner":"lmburns","description":"Kimbie Dark Neovim colorscheme","archived":false,"fork":false,"pushed_at":"2023-09-02T01:19:15.000Z","size":468,"stargazers_count":67,"open_issues_count":0,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-07-31T20:48:57.023Z","etag":null,"topics":["kimbie-dark","neovim-colorscheme","neovim-theme"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lmburns.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2021-02-11T06:55:05.000Z","updated_at":"2024-05-28T05:29:53.000Z","dependencies_parsed_at":"2024-01-03T03:29:37.955Z","dependency_job_id":"12d0ca3d-5e7f-4f9b-8411-042c74030ade","html_url":"https://github.com/lmburns/kimbox","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lmburns%2Fkimbox","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lmburns%2Fkimbox/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lmburns%2Fkimbox/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lmburns%2Fkimbox/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lmburns","download_url":"https://codeload.github.com/lmburns/kimbox/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243618667,"owners_count":20320273,"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":["kimbie-dark","neovim-colorscheme","neovim-theme"],"created_at":"2024-07-30T20:01:17.231Z","updated_at":"2025-03-14T17:31:08.745Z","avatar_url":"https://github.com/lmburns.png","language":"Lua","funding_links":[],"categories":["Colorscheme","Lua"],"sub_categories":["Tree-sitter Supported Colorscheme"],"readme":"![Kimbox](https://lmburns.com/gallery/media/large/kimbox-rust.png)\n\nKimbox is a dark colorscheme for Neovim with builtin treesitter support. It is my variation of the  [original `Kimbie Dark` colorscheme](https://marketplace.visualstudio.com/items?itemName=dnamsons.kimbie-dark-plus).\n\nThe colors may look duller in the images provided, though they will not be whenever the colorscheme is actually loaded. I've noticed that many other colorschemes seem brighter than what their images show.\n\n## Installation\n\n- vim-plug\n```vim\nPlug 'lmburns/kimbox'\n\ncolorscheme kimbox\n```\n\n- Packer\n```lua\nuse({\"lmburns/kimbox\", config = [[require(\"kimbox\").load()]]})\n-- or\nuse({\n    \"lmburns/kimbox\",\n    config = function()\n        require(\"kimbox\").setup({\n            -- options\n        })\n        require(\"kimbox\").load()\n        -- or\n        vim.cmd(\"colorscheme kimbox\")\n    end,\n})\n```\n\n- Bufferline\n```lua\n-- Colors can be accessed with\nlocal c = require(\"kimbox.bufferline\").colors()\n\n-- Theme itself\nlocal t = require(\"kimbox.bufferline\").theme()\n\nrequire(\"bufferline\").setup({\n  -- configuration stuff\n  highlights = require(\"kimbox.bufferline\").theme()\n})\n```\n\n- Lualine\n```lua\n-- Colors can be accessed with\nlocal c = require(\"kimbox.lualine\").colors()\n\n-- Theme itself\nlocal t = require(\"kimbox.lualine\").theme()\n\nrequire(\"lualine\").setup({\n  -- configuration stuff\n  theme = 'kimbox' -- 'auto' works as well\n})\n```\n\n## Color\n\n| #39260E                                                             | #291804                                                                 | #EF1D55                                                             | #DC3958                                                             | #FF5813                                                             | #FF9500                                                             | #819C3B                                                             |\n| ---------------------------------------------------------------     | ---------------------------------------------------------------         | ---------------------------------------------------------------     | ---------------------------------------------------------------     | ---------------------------------------------------------------     | ---------------------------------------------------------------     | ---------------------------------------------------------------     |\n| ![#39260E](https://via.placeholder.com/80/39260E/000000.png?text=+) | ![#291804](https://via.placeholder.com/80/291804.png/000000.png?text=+) | ![#EF1D55](https://via.placeholder.com/80/EF1D55/000000.png?text=+) | ![#DC3958](https://via.placeholder.com/80/DC3958/000000.png?text=+) | ![#FF5813](https://via.placeholder.com/80/FF5813/000000.png?text=+) | ![#FF9500](https://via.placeholder.com/80/FF9500/000000.png?text=+) | ![#819C3B](https://via.placeholder.com/80/819C3B/000000.png?text=+) |\n| #7EB2B1                                                             | #4C96A8                                                                 | #98676A                                                             | #A06469                                                             | #7F5D38                                                             | #A89984                                                             | #D9AE80                                                             |\n| ![#7EB2B1](https://via.placeholder.com/80/7EB2B1/000000.png?text=+) | ![#4C96A8](https://via.placeholder.com/80/4C96A8/000000.png?text=+)     | ![#98676A](https://via.placeholder.com/80/98676A/000000.png?text=+) | ![#A06469](https://via.placeholder.com/80/A06469/000000.png?text=+) | ![#7F5D38](https://via.placeholder.com/80/7F5D38/000000.png?text=+) | ![#A89984](https://via.placeholder.com/80/A89984/000000.png?text=+) | ![#D9AE80](https://via.placeholder.com/80/D9AE80/000000.png?text=+) |\n\n## Options (Lua)\n\n```lua\n-- These options can also be set using:\nvim.g.kimbox_config = {\n  -- ...options from above\n}\n\nrequire(\"kimbox\").setup({\n    ---Background color:\n    ---    burnt_coffee : #231A0C   -- legacy: \"medium\"\n    ---    cannon       : #221A02   -- legacy: \"ocean\"\n    ---    used_oil     : #221A0F   -- legacy: \"vscode\"\n    ---    deep         : #0F111B\n    ---    zinnwaldite  : #291804   -- legacy: \"darker\"\n    ---    eerie        : #1C0B28\n    style = \"cannon\",\n    ---Allow changing background color\n    toggle_style = {\n        ---Key used to cycle through the backgrounds in `toggle_style.bgs`\n        key = \"\u003cLeader\u003ets\",\n        ---List of background names\n        bgs = require(\"kimbox.config\").bg_colors\n    },\n    ---New Lua-Treesitter highlight groups\n    ---See below (New Lua Treesitter Highlight Groups) for an explanation\n    ---  Location where Treesitter capture groups changed to '@capture.name'\n    ---  Commit:    030b422d1\n    ---  Vim patch: patch-8.2.0674\n    langs08 = true,\n    ---Used with popup menus (coc.nvim mainly) --\n    popup = {\n        background = false, -- use background color for PMenu\n    },\n    -- ━━━ Plugin Related ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n    diagnostics = {\n        background = true, -- use background color for virtual text\n    },\n    -- ━━━ General Formatting ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n    allow_bold = true,\n    allow_italic = false,\n    allow_underline = false,\n    allow_undercurl = true,\n    allow_reverse = false,\n    transparent = false,   -- don't set background\n    term_colors = true,    -- if true enable the terminal\n    ending_tildes = false, -- show the end-of-buffer tildes\n    -- ━━━ Custom Highlights ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n    ---Override default colors\n    ---@type table\u003cKimbox.Color.S_t, string\u003e\n    colors = {},\n    ---Override highlight groups\n    ---@type Kimbox.Highlight.Map\n    highlights = {},\n    ---Plugins and langauges that can be disabled\n    ---To view options: print(require(\"kimbox.highlights\").{langs,langs08,plugins})\n    ---@type {langs: Kimbox.Highlight.Langs[], langs08: Kimbox.Highlight.Langs08[], plugins: Kimbox.Highlight.Plugins[]}\n    disabled = {\n        ---Disabled languages\n        ---@see Kimbox.Highlight.Langs\n        langs = {},\n        ---Disabled languages with '@' treesitter highlights\n        ---@see Kimbox.Highlight.Langs08\n        langs08 = {},\n        ---Disabled plugins\n        ---@see Kimbox.Highlight.Plugins\n        plugins = {},\n    },\n    ---Run a function before the colorscheme is loaded\n    ---@type fun(): nil\n    run_before = nil,\n    ---Run a function after the colorscheme is loaded\n    ---@type fun(): nil\n    run_after = nil,\n})\n\nrequire(\"kimbox\").load()\n```\n\n### Options (vimscript)\n\n```vim\n\" an example\nlet g:kimbox_config = #{\n    \\ style: 'cannon',\n    \\ toggle_style: #{\n    \\   key: '\u003cLeader\u003ets',\n    \\   bgs: [\n    \\     'burnt_coffee',\n    \\     'cannon',\n    \\     'used_oil',\n    \\     'deep',\n    \\     'zinnwaldite',\n    \\     'eerie',\n    \\   ]\n    \\ },\n    \\ langs08: v:false,\n    \\ diagnostics: #{background: v:true},\n    \\ popup:       #{background: v:false},\n    \\ allow_bold: v:true,\n    \\ allow_italic: v:false,\n    \\ allow_underline: v:false,\n    \\ allow_undercurl: v:true,\n    \\ allow_reverse: v:false,\n    \\ transparent: v:false,\n    \\ term_colors: v:true,\n    \\ ending_tildes: v:false,\n    \\ colors: [],\n    \\ highlights: [],\n    \\ disabled: #{\n    \\   langs:   [],\n    \\   langs08: [],\n    \\   plugins: [],\n    \\ },\n    \\ run_before: v:null,\n    \\ run_after: v:null,\n    \\ }\n\ncolorscheme kimbox\n```\n\n### Overriding highlight groups\n\n```lua\nrequire(\"kimbox\").setup({\n    colors = {\n        bright_orange = \"#ff8800\", -- define a new color\n        green = \"#77A172\",         -- redefine an existing color\n        myblue = \"#418292\",\n    },\n    highlights = {\n        TSKeyword = {fg = \"$green\"},\n        TSString = {fg = \"$bright_orange\", bg = \"#FF5813\", gui = \"bold\"},\n        TSFunction = {fg = \"#88C0D0\", sp = \"$aqua\", gui = \"underline,italic\"},\n        [\"@function.macro.lua\"] = {fg = \"$myblue\", sp = \"$aqua\", gui = \"underline,italic\"},\n    },\n})\n```\n\n## New Lua Treesitter Highlight Groups\n\nSee `:h lua-treesitter-highlight-groups` for a full explanation.\n\nAfter the commit `030b422d1`, highlight groups were changed in the following pattern:\n* `luaTSFunction` =\u003e `@function.lua`\n* `vimdocTSTitle` =\u003e `@text.title.vimdoc`\n* etc.\n\nThis feature will **not yet be enabled by default**. If you wish to use this colorscheme and wish to have the exact same colors as the highlight groups that were present before the aforementioned commit, set the configuration feature `langs08` to `true` in your configuration. This feature will eventually be this colorschemes default settings.\n\n## Filetype Support\n\nTreesitter is preferred for most file types (not Zsh).\nAll of the following languages have been manually configured.\n\n\u003cdetails\u003e\n\u003csummary\u003eSupport\u003c/summary\u003e\n\n- Awk\n- Bash/Dash\n- C/C++\n- Clojure\n- CoffeeScript\n- Dart\n- Elixir\n- Erlang\n- Go\n- Haskell\n- HTML\n- Javascript\n- JavascriptReact TypescriptReact\n- Kotlin\n- Lua\n- OCaml\n- ObjectiveC\n- PHP\n- Perl\n- Python\n- R\n- Ruby\n- Rust\n- Scala\n- Sed\n- Solidity\n- Swift\n- Teal\n- Typescript\n- TypescriptReact (`.tsx`)\n- Vimscript\n- Zig\n- Zsh\n\n- CSS\n- SCSS\n- GraphQL\n- JQ\n- Comments\n- Vimdoc (Vim help)\n- LuaDoc (Lua documentation comments)\n- Luap (Lua patterns)\n- Query (`.scm`, Treesitter query syntax)\n- Regex\n- Latex\n- Markdown\n- Matlab\n\n- sxhkdrc\n- CMake\n- Makefile\n- Git Commit\n- Git Config\n- Git Ignore\n- DosIni (`.ini`)\n- JSON\n- RON (Rust Object Notation)\n- TOML\n- YAML\n\n\u003c/details\u003e\n\n## Plugin Support\n- If any plugin is not supported and you would like for it to be, please let me know.\n\n\u003cdetails\u003e\n\u003csummary\u003eSupport\u003c/summary\u003e\n\n- [Aerial](https://github.com/stevearc/aerial.nvim)\n- [Ale](https://github.com/dense-analysis/ale)\n- [Barbar](https://github.com/romgrk/barbar.nvim)\n- [BufferLine](https://github.com/akinsho/nvim-bufferline.lua)\n- [Cmp](https://github.com/hrsh7th/nvim-cmp)\n- [Coc-Explorer](https://github.com/weirongxu/coc-explorer)\n- [Coc-Git](https://github.com/neoclide/coc-git)\n- [Coc.nvim](https://github.com/neoclide/coc.nvim)\n- [Cybu](https://github.com/ghillb/cybu.nvim)\n- [Dap-UI](https://github.com/rcarriga/nvim-dap-ui)\n- [Dashboard](https://github.com/glepnir/dashboard-nvim)\n- [Defx](https://github.com/Shougo/defx.nvim)\n- [DiffView](https://github.com/sindrets/diffview.nvim)\n- [EasyMotion](https://github.com/easymotion/vim-easymotion)\n- [Fern](https://github.com/lambdalisue/fern.vim)\n- [Floaterm](https://github.com/voldikss/vim-floaterm)\n- [Fzf-Lua](https://github.com/ibhagwan/fzf-lua)\n- [Git Gutter](https://github.com/airblade/vim-gitgutter)\n- [Git Signs](https://github.com/lewis6991/gitsigns.nvim)\n- [HlArgs](https://github.com/m-demare/hlargs.nvim)\n- [Hop](https://github.com/phaazon/hop.nvim)\n- [Incline](https://github.com/b0o/incline.nvim)\n- [Indent Blankline](https://github.com/lukas-reineke/indent-blankline.nvim)\n- [LSP Diagnostics](https://neovim.io/doc/user/lsp.html)\n- [LSP Saga](https://github.com/glepnir/lspsaga.nvim)\n- [LSP Trouble](https://github.com/folke/lsp-trouble.nvim)\n- [Lightline](https://github.com/itchyny/lightline.vim)\n- [Lightspeed](https://github.com/ggandor/lightspeed.nvim)\n- [Lualine](https://github.com/hoob3rt/lualine.nvim)\n- [Marks](https://github.com/chentau/marks.nvim)\n- [Modes](https://github.com/mvllow/modes.nvim)\n- [Neogit](https://github.com/TimUntersberger/neogit)\n- [Neomake](https://github.com/neomake/neomake)\n- [Neotest](https://github.com/rcarriga/neotest)\n- [NerdIcons](https://github.com/glepnir/nerdicons.nvim)\n- [NerdTree](https://github.com/preservim/nerdtree)\n- [Noice](https://github.com/folke/noice.nvim)\n- [Nvim-Notify](https://github.com/rcarriga/nvim-notify)\n- [Nvim-R](https://github.com/jalvesaq/Nvim-R)\n- [NvimTree](https://github.com/kyazdani42/nvim-tree.lua)\n- [Overseer](https://github.com/stevearc/overseer.nvim)\n- [Packer](https://github.com/wbthomason/packer.nvim)\n- [Registers](https://github.com:tversteeg/registers.nvim)\n- [Sneak](https://github.com/justinmk/vim-sneak)\n- [Startify](https://github.com/mhinz/vim-startify)\n- [Symbols Outline](https://github.com/simrat39/symbols-outline.nvim)\n- [Telescope](https://github.com/nvim-telescope/telescope.nvim)\n- [Treesitter](https://github.com/nvim-treesitter/nvim-treesitter)\n- [Treesitter Treehopper](https://github.com/mfussenegger/nvim-treehopper)\n- [Treesitter Rainbow](https://github.com/p00f/nvim-ts-rainbow)\n- [Treesitter Rainbow 2](https://github.com/HiPhish/nvim-ts-rainbow2)\n- [VimWiki](https://github.com/vimwiki/vimwiki)\n- [Vimtex](https://github.com/lervag/vimtex)\n- [Vista.vim](https://github.com/liuchengxu/vista.vim)\n- [WhichKey](https://github.com/folke/which-key.nvim)\n- [dart-vim-plugin](https://github.com/dart-lang/dart-vim-plugin)\n- [haskell-vim](https://github.com/neovimhaskell/haskell-vim)\n- [kotlin-vim](https://github.com/udalov/kotlin-vim)\n- [php.vim](https://github.com/StanAngeloff/php.vim)\n- [python-syntax](https://github.com/vim-python/python-syntax,)\n- [ron.vim](https://github.com/ron-rs/ron.vim)\n- [rust.vim](https://github.com/rust-lang/rust.vim)\n- [semshi](https://github.com/numirias/semshi,)\n- [swift.vim](https://github.com/keith/swift.vim)\n- [vim-clojure-static](https://github.com/guns/vim-clojure-static)\n- [vim-coffee-script](https://github.com/kchmck/vim-coffee-script)\n- [vim-elixir](https://github.com/elixir-editors/vim-elixir)\n- [vim-erlang-runtime](https://github.com/vim-erlang/vim-erlang-runtime)\n- [vim-illuminate](https://github.com/RRethy/vim-illuminate)\n- [vim-javascript](https://github.com/pangloss/vim-javascript)\n- [vim-jsx-pretty](https://github.com/maxmellon/vim-jsx-pretty)\n- [vim-ocaml](https://github.com/rgrinberg/vim-ocaml)\n- [vim-perl](https://github.com/vim-perl/vim-perl)\n- [vim-ruby](https://github.com/vim-ruby/vim-ruby)\n- [vim-scala](https://github.com/derekwyatt/vim-scala)\n- [vim-solidity](https://github.com/thesis/vim-solidity)\n- [vim-SpellCheck](https://github.com/inkarkat/vim-SpellCheck)\n- [vim-typescript](https://github.com/leafgarland/typescript-vim)\n- [yajs](https://github.com/othree/yajs.vim,)\n- [yats](https:github.com/HerringtonDarkholme/yats.vim)\n\n\u003c/details\u003e\n\n### Name\nThe name came about because I had originally thought I was going to create a combination of the kimbie dark and gruvbox colorschemes. It's too late to change it now.\n\n### Extras\n- There is a supplemental TextMate theme in the `extras` directory. This can be used with [`bat`](https://github.com/sharkdp/bat) or SublimeText.\n- There are also files which can be used with [`wezterm`](https://github.com/wez/wezterm). One is the theme itself, and the other contains configuration options to setup the theme.\n\n### TODO\n- Create some sort of documentation\n- Create a compiled version similar to `nightfox`\n\n## Thanks to\n\n- [glepnir/oceanic-material](https://github.com/glepnir/oceanic-material)\n- [navarasu/onedark.nvim](https://github.com/navarasu/onedark.nvim)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flmburns%2Fkimbox","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flmburns%2Fkimbox","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flmburns%2Fkimbox/lists"}