Professional Documents
Culture Documents
Tokyonight Nvim
Tokyonight Nvim
==============================================================================
Table of Contents *tokyonight.nvim-table-of-contents*
==============================================================================
1. Tokyo Night *tokyonight.nvim-tokyo-night*
STORM *tokyonight.nvim-tokyo-night-storm*
NIGHT *tokyonight.nvim-tokyo-night-night*
MOON *tokyonight.nvim-tokyo-night-moon*
DAY *tokyonight.nvim-tokyo-night-day*
FEATURES *tokyonight.nvim-tokyo-night-features*
EXTRAS ~
REQUIREMENTS *tokyonight.nvim-tokyo-night-requirements*
INSTALLATION *tokyonight.nvim-tokyo-night-installation*
Install the theme with your preferred package manager, such as folke/lazy.nvim
<https://github.com/folke/lazy.nvim>
>lua
{
"folke/tokyonight.nvim",
lazy = false,
priority = 1000,
opts = {},
}
<
USAGE *tokyonight.nvim-tokyo-night-usage*
VIM SCRIPT ~
>vim
colorscheme tokyonight
LUA ~
>lua
vim.cmd[[colorscheme tokyonight]]
<
EXTERNAL PLUGINS
BARBECUE
>lua
-- Lua
require('barbecue').setup {
-- ... your barbecue config
theme = 'tokyonight',
-- ... your barbecue config
}
<
LUALINE
>lua
-- Lua
require('lualine').setup {
options = {
-- ... your lualine config
theme = 'tokyonight'
-- ... your lualine config
}
}
<
LIGHTLINE
>vim
" Vim Script
let g:lightline = {'colorscheme': 'tokyonight'}
<
CONFIGURATION *tokyonight.nvim-tokyo-night-configuration*
Set the configuration **BEFORE** loading the color scheme with `colorscheme
tokyonight`.
The theme offers four styles: |tokyonight.nvim-storm|, |tokyonight.nvim-moon|,
|tokyonight.nvim-night|, and |tokyonight.nvim-day|.
The |tokyonight.nvim-day| style is used when `{ style = "day" }` is passed to
`setup(options)` or when `vim.o.background = "light"`.
>lua
require("tokyonight").setup({
-- your configuration comes here
-- or leave it empty to use the default settings
style = "storm", -- The theme comes in three styles, `storm`, `moon`, a
darker variant `night` and `day`
light_style = "day", -- The theme is used when the background is set to light
transparent = false, -- Enable this to disable setting the background color
terminal_colors = true, -- Configure the colors used when opening a
`:terminal` in [Neovim](https://github.com/neovim/neovim)
styles = {
-- Style to be applied to different syntax groups
-- Value is any valid attr-list value for `:help nvim_set_hl`
comments = { italic = true },
keywords = { italic = true },
functions = {},
variables = {},
-- Background styles. Can be "dark", "transparent" or "normal"
sidebars = "dark", -- style for sidebars, see below
floats = "dark", -- style for floating windows
},
sidebars = { "qf", "help" }, -- Set a darker background on sidebar-like
windows. For example: `["qf", "vista_kind", "terminal", "packer"]`
day_brightness = 0.3, -- Adjusts the brightness of the colors of the **Day**
style. Number between 0 and 1, from dull to vibrant colors
hide_inactive_statusline = false, -- Enabling this option, will hide inactive
statuslines and replace them with a thin border instead. Should work with the
standard **StatusLine** and **LuaLine**.
dim_inactive = false, -- dims inactive windows
lualine_bold = false, -- When `true`, section headers in the lualine theme
will be bold
--- You can override specific color groups to use other groups or a hex color
--- function will be called with a ColorScheme table
---@param colors ColorScheme
on_colors = function(colors) end,
--- You can override specific highlights to use other groups or a hex color
--- function will be called with a Highlights and ColorScheme table
---@param highlights Highlights
---@param colors ColorScheme
on_highlights = function(highlights, colors) end,
})
<
For default values of `colors` and `highlights`, please consult the storm
<extras/lua/tokyonight_storm.lua>, moon <extras/lua/tokyonight_moon.lua>, night
<extras/lua/tokyonight_night.lua>, and day <extras/lua/tokyonight_day.lua>
themes.
>lua
require("tokyonight").setup({
-- use the night style
style = "night",
-- disable italic for functions
styles = {
functions = {}
},
sidebars = { "qf", "vista_kind", "terminal", "packer" },
-- Change the "hint" color to the "orange" color, and make the "error" color
bright red
on_colors = function(colors)
colors.hint = colors.orange
colors.error = "#ff0000"
end
})
<
>lua
require("tokyonight").setup({
on_highlights = function(hl, c)
local prompt = "#2d3149"
hl.TelescopeNormal = {
bg = c.bg_dark,
fg = c.fg_dark,
}
hl.TelescopeBorder = {
bg = c.bg_dark,
fg = c.bg_dark,
}
hl.TelescopePromptNormal = {
bg = prompt,
}
hl.TelescopePromptBorder = {
bg = prompt,
fg = prompt,
}
hl.TelescopePromptTitle = {
bg = prompt,
fg = prompt,
}
hl.TelescopePreviewTitle = {
bg = c.bg_dark,
fg = c.bg_dark,
}
hl.TelescopeResultsTitle = {
bg = c.bg_dark,
fg = c.bg_dark,
}
end,
})
<
To have undercurls show up and in color, add the following to your Tmux
<https://github.com/tmux/tmux> configuration file:
>sh
# Undercurl
set -g default-terminal "${TERM}"
set -as terminal-overrides ',*:Smulx=\E[4::%p1%dm' # undercurl support
set -as terminal-overrides
',*:Setulc=\E[58::2::%p1%{65536}%/%d::%p1%{256}%/%{255}%&%d::%p1%{255}%&%d%;m' #
underscore colours - needs tmux-3.0
<
EXTRAS *tokyonight.nvim-tokyo-night-extras*
You can easily use the color palette for other plugins inside your Neovim
<https://github.com/neovim/neovim> configuration:
>lua
local colors = require("tokyonight.colors").setup() -- pass in any of the
config options as explained above
local util = require("tokyonight.util")
aplugin.background = colors.bg_dark
aplugin.my_error = util.lighten(colors.red1, 0.3) -- number between 0 and 1. 0
results in white, 1 results in red1
<
CONTRIBUTING *tokyonight.nvim-tokyo-night-contributing*
>sh
nvim --headless "+lua require('tokyonight.extra').setup()" +qa
<
4. Check the newly created themes in the `extra/` directory. Please **DO NOT**
commit them, as they are already automatically built by the CI.
==============================================================================
2. Links *tokyonight.nvim-links*
1. *image*: https://user-images.githubusercontent.com/292349/115295095-3a9e5080-
a10e-11eb-9aed-6054488c46ce.png
2. *image*: https://user-images.githubusercontent.com/292349/115295327-7afdce80-
a10e-11eb-89b3-2591262bf95a.png
3. *image*: https://user-images.githubusercontent.com/292349/190951628-10ba28a1-
57ff-4479-8eab-47400a402242.png
4. *image*: https://user-images.githubusercontent.com/292349/115996270-78c6c480-
a593-11eb-8ed0-7d1400b058f5.png
5. *image*: https://user-images.githubusercontent.com/292349/115395546-d8d6f880-
a198-11eb-98fb-a1194787701d.png
vim:tw=78:ts=8:noet:ft=help:norl: