mirror of
https://github.com/webhooked/kanso.nvim.git
synced 2026-06-04 16:17:00 +02:00
285 lines
7.2 KiB
Markdown
285 lines
7.2 KiB
Markdown
<div align="center">
|
|
<h1>🌊 Kansō.nvim 🌊</h1>
|
|
</div>
|
|
|
|
<div align="center">
|
|
<p>
|
|
Kansō is an elegant evolution of the original Kanagawa theme.
|
|
<br/>
|
|
A dark theme that invites <em>focus</em>, not attention.
|
|
</p>
|
|
</div>
|
|
|
|
<div align="center">
|
|
|
|
[](https://neovim.io/)
|
|
[](https://www.w3.org/TR/WCAG21/#contrast-minimum)
|
|
|
|
<img src="kanso.png" width="1000" />
|
|
</div>
|
|
|
|
<br/>
|
|
|
|
<div>
|
|
<img src="showcase.png" width="1000" />
|
|
</div>
|
|
|
|
## ✨ Features
|
|
|
|
- 🌈 Extensive support for `TreeSitter` syntax highlighting
|
|
- 🔌 Compatible with popular plugins out of the box
|
|
- ⚡ Compilation to lua byte code for fast startup times
|
|
- 🎨 Three beautiful theme variants to match your mood and environment
|
|
- 👁️ WCAG 2.1 AA compliant
|
|
|
|
## 📦 Installation
|
|
|
|
Download with your favorite package manager.
|
|
|
|
```lua
|
|
-- Using Packer
|
|
use "webhooked/kanso.nvim"
|
|
|
|
-- Using Lazy
|
|
{
|
|
"webhooked/kanso.nvim",
|
|
lazy = false,
|
|
priority = 1000,
|
|
}
|
|
```
|
|
|
|
## 📋 Requirements
|
|
|
|
- Terminal with truecolor support
|
|
- Terminal with undercurl support (optional)
|
|
|
|
## 🚀 Usage
|
|
|
|
As simple as writing:
|
|
|
|
```vim
|
|
colorscheme kanso
|
|
```
|
|
|
|
Or in Lua:
|
|
|
|
```lua
|
|
vim.cmd("colorscheme kanso")
|
|
```
|
|
|
|
## ⚙️ Configuration
|
|
|
|
There is no need to call setup if you are ok with the defaults.
|
|
|
|
```lua
|
|
-- Default options:
|
|
require('kanso').setup({
|
|
compile = false, -- enable compiling the colorscheme
|
|
undercurl = true, -- enable undercurls
|
|
commentStyle = { italic = true },
|
|
functionStyle = {},
|
|
keywordStyle = { italic = true},
|
|
statementStyle = {},
|
|
typeStyle = {},
|
|
transparent = false, -- do not set background color
|
|
dimInactive = false, -- dim inactive window `:h hl-NormalNC`
|
|
terminalColors = true, -- define vim.g.terminal_color_{0,17}
|
|
colors = { -- add/modify theme and palette colors
|
|
palette = {},
|
|
theme = { zen = {}, pearl = {}, ink = {}, all = {} },
|
|
},
|
|
overrides = function(colors) -- add/modify highlights
|
|
return {}
|
|
end,
|
|
theme = "zen", -- Load "zen" theme
|
|
background = { -- map the value of 'background' option to a theme
|
|
dark = "zen", -- try "ink" !
|
|
light = "pearl"
|
|
},
|
|
})
|
|
|
|
-- setup must be called before loading
|
|
vim.cmd("colorscheme kanso")
|
|
```
|
|
|
|
<details>
|
|
<summary><strong>💡 Important Notes</strong></summary>
|
|
|
|
**Compilation:** If you enable compilation, make sure to run `:KansōCompile` command every time you make changes to your config.
|
|
|
|
```vim
|
|
" 1. Modify your config
|
|
" 2. Restart nvim
|
|
" 3. Run this command:
|
|
:KansōCompile
|
|
```
|
|
|
|
**Options:** Kansō adjusts to the value of some options. Make sure that the options `'laststatus'` and `'cmdheight'` are set **_before_** calling `setup`.
|
|
|
|
</details>
|
|
|
|
## 🎨 Themes
|
|
|
|
Kansō comes in three beautiful variants:
|
|
|
|
- `Zen` (Dark)
|
|
- `Ink` (Dark)
|
|
- `Pearl` (Light)
|
|
|
|
<div>
|
|
<h3>✧ Zen ✧</h3>
|
|
<p>Deep & rich dark theme for focused coding.</p>
|
|
<img src="kanso_zen.png" width="900">
|
|
<br/><br/>
|
|
|
|
<h3>✧ Ink ✧</h3>
|
|
<p>Balanced theme with elegant contrast.</p>
|
|
<img src="kanso_ink.png" width="900">
|
|
<br/><br/>
|
|
|
|
<h3>✧ Pearl ✧</h3>
|
|
<p>Light theme for daytime productivity.</p>
|
|
<img src="kanso_pearl.png" width="900">
|
|
</div>
|
|
|
|
<br/>
|
|
|
|
<details>
|
|
<summary><strong>🔄 Switching Between Themes</strong></summary>
|
|
|
|
Themes can be changed in three ways:
|
|
|
|
1. Setting `config.theme` to the desired theme.
|
|
2. Using the `background` option:
|
|
Any change to the value of `vim.o.background` will select the theme mapped by `config.background`.
|
|
3. Loading the colorscheme directly with:
|
|
|
|
```lua
|
|
vim.cmd("colorscheme kanso-zen")
|
|
vim.cmd("colorscheme kanso-kage")
|
|
vim.cmd("colorscheme kanso-pearl")
|
|
```
|
|
|
|
or
|
|
|
|
```lua
|
|
require("kanso").load("zen")
|
|
```
|
|
|
|
</details>
|
|
|
|
## 🧰 Customization
|
|
|
|
In Kansō, there are _two_ kinds of colors: `PaletteColors` and `ThemeColors`;
|
|
`PaletteColors` are defined directly as RGB Hex strings, and have arbitrary names
|
|
that recall their actual color. Conversely, `ThemeColors` are named and grouped _semantically_
|
|
on the basis of their actual function.
|
|
|
|
In short, a `palette` defines all the available colors, while a `theme` maps the `PaletteColors`
|
|
to specific `ThemeColors` and the same palette color may be assigned to multiple theme colors.
|
|
|
|
<details>
|
|
<summary><strong>📝 Color Customization Example</strong></summary>
|
|
|
|
You can change _both_ theme or palette colors using `config.colors`.
|
|
All the palette color names can be found [here](lua/kanso/colors.lua),
|
|
while their usage by each theme can be found [here](lua/kanso/themes.lua).
|
|
|
|
```lua
|
|
require('kanso').setup({
|
|
...,
|
|
colors = {
|
|
palette = {
|
|
-- change all usages of these colors
|
|
zen0 = "#000000",
|
|
fujiWhite = "#FFFFFF",
|
|
},
|
|
theme = {
|
|
-- change specific usages for a certain theme, or for all of them
|
|
zen = {
|
|
ui = {
|
|
float = {
|
|
bg = "none",
|
|
},
|
|
},
|
|
},
|
|
ink = {
|
|
syn = {
|
|
parameter = "yellow",
|
|
},
|
|
},
|
|
all = {
|
|
ui = {
|
|
bg_gutter = "none"
|
|
}
|
|
}
|
|
}
|
|
},
|
|
...
|
|
})
|
|
```
|
|
|
|
</details>
|
|
|
|
<details>
|
|
<summary><strong>🔧 Highlight Group Overrides</strong></summary>
|
|
|
|
You can also conveniently add/modify any `hlgroups` using the `config.overrides` option, allowing you to customize the looks of specific built-in elements, or any other external plugins that provides `hlgroups`. (See `:help highlight` for more information on `hlgroups`.)
|
|
Supported keywords are the same for `:h nvim_set_hl` `{val}` parameter.
|
|
|
|
```lua
|
|
require('kanso').setup({
|
|
...,
|
|
overrides = function(colors)
|
|
return {
|
|
-- Assign a static color to strings
|
|
String = { fg = colors.palette.carpYellow, italic = true },
|
|
-- theme colors will update dynamically when you change theme!
|
|
SomePluginHl = { fg = colors.theme.syn.type, bold = true },
|
|
}
|
|
end,
|
|
...
|
|
})
|
|
```
|
|
|
|
</details>
|
|
|
|
## 🔄 Integration
|
|
|
|
### Get palette and theme colors
|
|
|
|
```lua
|
|
-- Get the colors for the current theme
|
|
local colors = require("kanso.colors").setup()
|
|
local palette_colors = colors.palette
|
|
local theme_colors = colors.theme
|
|
|
|
-- Get the colors for a specific theme
|
|
local zen_colors = require("kanso.colors").setup({ theme = 'ink' })
|
|
```
|
|
|
|
## 🧩 Extras
|
|
|
|
<div>
|
|
|
|
- [Alacritty](extras/alacritty/)
|
|
- [Kitty](extras/kitty/)
|
|
- [Ghostty](extras/ghostty)
|
|
- [Wezterm](extras/wezterm/)
|
|
- [Kansō for VS Code](https://marketplace.visualstudio.com/items?itemName=webhooked.kanso-theme)
|
|
- [Kansō for Zed](https://github.com/webhooked/kanso-zed)
|
|
|
|
</div>
|
|
|
|
## 💎 Credits
|
|
|
|
The theme is inspired by the Kanagawa theme.
|
|
|
|
- [rebelot](https://github.com/rebelot/kanagawa.nvim) for the original Kanagawa Neovim theme
|
|
|
|
## 🙏 Acknowledgements
|
|
|
|
- [Kanagawa](https://github.com/rebelot/kanagawa.nvim)
|
|
- [Tokyonight](https://github.com/folke/tokyonight.nvim)
|
|
- [Gruvbox](https://github.com/morhetz/gruvbox)
|
|
- [Catppuccin](https://github.com/catppuccin/nvim)
|