2021-04-19 19:40:12 +00:00
# 🏙 Tokyo Night
2021-04-24 20:24:40 +00:00
A dark and light Neovim theme written in Lua ported from the Visual Studio Code [TokyoNight ](https://github.com/enkia/tokyo-night-vscode-theme ) theme. Includes extra themes for Kitty, Alacritty, iTerm and Fish.
2021-04-19 19:40:12 +00:00
2021-04-19 19:55:58 +00:00
## Storm
![image ](https://user-images.githubusercontent.com/292349/115295095-3a9e5080-a10e-11eb-9aed-6054488c46ce.png )
## Night
![image ](https://user-images.githubusercontent.com/292349/115295327-7afdce80-a10e-11eb-89b3-2591262bf95a.png )
2021-04-24 20:24:40 +00:00
## Day
2021-04-25 13:57:39 +00:00
![image ](https://user-images.githubusercontent.com/292349/115996270-78c6c480-a593-11eb-8ed0-7d1400b058f5.png )
2021-04-19 19:40:12 +00:00
## ✨ Features
2021-06-25 12:35:09 +00:00
- supports the latest Neovim 5.0 features like TreeSitter and LSP
- minimal inactive statusline
- vim terminal colors
- darker background for sidebar-like windows
- color configs for [Kitty ](https://sw.kovidgoyal.net/kitty/conf.html?highlight=include ), [Alacritty ](https://github.com/alacritty/alacritty ) and [Fish Shell ](https://fishshell.com/ )
- **lualine** theme
2021-04-20 11:39:38 +00:00
### Plugin Support
2021-06-25 12:35:09 +00:00
- [TreeSitter ](https://github.com/nvim-treesitter/nvim-treesitter )
- [LSP Diagnostics ](https://neovim.io/doc/user/lsp.html )
- [LSP Trouble ](https://github.com/folke/lsp-trouble.nvim )
- [LSP Saga ](https://github.com/glepnir/lspsaga.nvim )
- [Git Signs ](https://github.com/lewis6991/gitsigns.nvim )
- [Git Gutter ](https://github.com/airblade/vim-gitgutter )
- [Telescope ](https://github.com/nvim-telescope/telescope.nvim )
- [NvimTree ](https://github.com/kyazdani42/nvim-tree.lua )
- [WhichKey ](https://github.com/liuchengxu/vim-which-key )
- [Indent Blankline ](https://github.com/lukas-reineke/indent-blankline.nvim )
- [Dashboard ](https://github.com/glepnir/dashboard-nvim )
- [BufferLine ](https://github.com/akinsho/nvim-bufferline.lua )
- [Lualine ](https://github.com/hoob3rt/lualine.nvim )
- [Lightline ](https://github.com/itchyny/lightline.vim )
- [Neogit ](https://github.com/TimUntersberger/neogit )
- [vim-sneak ](https://github.com/justinmk/vim-sneak )
- [Fern ](https://github.com/lambdalisue/fern.vim )
2021-07-20 07:41:49 +00:00
- [Barbar ](https://github.com/romgrk/barbar.nvim )
2022-09-02 05:54:15 +00:00
- [Mini ](https://github.com/echasnovski/mini.nvim )
2021-04-19 19:40:12 +00:00
2021-04-21 06:05:13 +00:00
## ⚡️ Requirements
2021-06-25 12:35:09 +00:00
- Neovim >= 0.5.0
2021-05-17 06:44:17 +00:00
2021-04-19 19:40:12 +00:00
## 📦 Installation
Install the theme with your preferred package manager:
[vim-plug ](https://github.com/junegunn/vim-plug )
```vim
2021-07-20 07:42:09 +00:00
Plug 'folke/tokyonight.nvim', { 'branch': 'main' }
2021-04-19 19:40:12 +00:00
```
[packer ](https://github.com/wbthomason/packer.nvim )
```lua
use 'folke/tokyonight.nvim'
```
## 🚀 Usage
Enable the colorscheme:
```vim
" Vim Script
colorscheme tokyonight
```
```lua
-- Lua
vim.cmd[[colorscheme tokyonight]]
```
To enable the `TokyoNight` theme for `Lualine` , simply specify it in your lualine settings:
```lua
require('lualine').setup {
2021-04-20 21:04:05 +00:00
options = {
-- ... your lualine config
theme = 'tokyonight'
-- ... your lualine config
}
2021-04-19 19:40:12 +00:00
}
```
2021-05-17 06:44:17 +00:00
To enable the `tokyonight` colorscheme for `Lightline` :
```vim
" Vim Script
let g:lightline = {'colorscheme': 'tokyonight'}
```
2021-04-19 19:40:12 +00:00
## ⚙️ Configuration
2021-04-25 10:22:01 +00:00
> ❗️ configuration needs to be set **BEFORE** loading the color scheme with `colorscheme tokyonight`
2021-04-24 20:24:40 +00:00
The theme comes in three styles, `storm` , a darker variant `night` and `day` .
2021-04-19 19:40:12 +00:00
2021-04-25 13:50:02 +00:00
The **day** style will be used if:
2022-09-02 05:58:02 +00:00
- `vim.g.tokyonight_style = "day"`
- or `vim.o.background = "light"`
2021-04-25 13:50:02 +00:00
2021-04-20 10:19:20 +00:00
| Option | Default | Description |
2021-06-25 12:35:09 +00:00
| ----------------------------------- | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
2021-04-24 20:24:40 +00:00
| tokyonight_style | `"storm"` | The theme comes in three styles, `storm` , a darker variant `night` and `day` . |
2021-04-20 10:19:20 +00:00
| tokyonight_terminal_colors | `true` | Configure the colors used when opening a `:terminal` in Neovim |
| tokyonight_italic_comments | `true` | Make comments italic |
| tokyonight_italic_keywords | `true` | Make keywords italic |
| tokyonight_italic_functions | `false` | Make functions italic |
2021-04-21 21:56:40 +00:00
| tokyonight_italic_variables | `false` | Make variables and identifiers italic |
2021-04-20 10:19:20 +00:00
| tokyonight_transparent | `false` | Enable this to disable setting the background color |
| tokyonight_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** . |
2021-04-23 18:21:12 +00:00
| tokyonight_sidebars | `{}` | Set a darker background on sidebar-like windows. For example: `["qf", "vista_kind", "terminal", "packer"]` |
2021-08-05 07:48:22 +00:00
| tokyonight_transparent_sidebar | `false` | Sidebar like windows like `NvimTree` get a transparent background |
2021-04-20 20:43:54 +00:00
| tokyonight_dark_sidebar | `true` | Sidebar like windows like `NvimTree` get a darker background |
| tokyonight_dark_float | `true` | Float windows like the lsp diagnostics windows get a darker background. |
2021-04-23 18:21:12 +00:00
| tokyonight_colors | `{}` | You can override specific color groups to use other groups or a hex color |
2021-05-19 06:49:33 +00:00
| tokyonight_day_brightness | `0.3` | Adjusts the brightness of the colors of the **Day** style. Number between 0 and 1, from dull to vibrant colors |
2021-06-25 12:35:09 +00:00
| tokyonight_lualine_bold | `false` | When `true` , section headers in the lualine theme will be bold |
2021-04-20 05:47:36 +00:00
2021-04-20 10:19:20 +00:00
```lua
-- Example config in Lua
vim.g.tokyonight_style = "night"
vim.g.tokyonight_italic_functions = true
2021-04-23 15:17:52 +00:00
vim.g.tokyonight_sidebars = { "qf", "vista_kind", "terminal", "packer" }
2021-04-23 18:21:12 +00:00
-- Change the "hint" color to the "orange" color, and make the "error" color bright red
vim.g.tokyonight_colors = { hint = "orange", error = "#ff0000" }
2021-04-25 10:22:01 +00:00
-- Load the colorscheme
vim.cmd[[colorscheme tokyonight]]
2021-04-19 19:40:12 +00:00
```
2021-04-20 05:47:36 +00:00
```vim
2021-04-20 10:19:20 +00:00
" Example config in VimScript
let g:tokyonight_style = "night"
2021-05-17 12:16:10 +00:00
let g:tokyonight_italic_functions = 1
2021-04-23 15:17:52 +00:00
let g:tokyonight_sidebars = [ "qf", "vista_kind", "terminal", "packer" ]
2021-04-25 10:22:01 +00:00
2021-10-21 10:32:23 +00:00
" Change the "hint" color to the "orange" color, and make the "error" color bright red
let g:tokyonight_colors = {
\ 'hint': 'orange',
\ 'error': '#ff0000'
\ }
2021-04-25 10:22:01 +00:00
" Load the colorscheme
colorscheme tokyonight
2021-04-20 05:47:36 +00:00
```
2021-04-20 11:39:38 +00:00
2021-04-30 06:43:16 +00:00
### Making `undercurls` work properly in **Tmux**
To have undercurls show up and in color, add the following to your **Tmux** config 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
```
2021-04-20 11:39:38 +00:00
## 🍭 Extras
2021-05-21 12:51:45 +00:00
Extra color configs for **Kitty** , **Alacritty** , **Fish** , **WezTerm** and **iTerm** can be found in [extras ](extras/ ). To use them, refer to their respective documentation.
2021-04-20 12:26:02 +00:00
![image ](https://user-images.githubusercontent.com/292349/115395546-d8d6f880-a198-11eb-98fb-a1194787701d.png )
2021-06-04 06:26:02 +00:00
2021-08-05 07:48:22 +00:00
You can easily use the color palette for other plugins inside your Neovim config:
```lua
local colors = require("tokyonight.colors").setup({}) -- pass in any of the config options as explained above
2022-09-02 05:57:31 +00:00
local utils = require("tokyonight.util")
2021-08-05 07:48:22 +00:00
aplugin.background = colors.bg_dark
aplugin.my_error = util.brighten(colors.red1, 0.3)
```
2021-06-04 06:26:02 +00:00
## 🔥 Contributing
Pull requests are welcome. For the `extras` , we use a simple template system that can be used to generate themes for the different styles.
How to add a new extra template:
1. create a file like `lua/tokyonight/extra/cool-app.lua`
2. add the name and output file extension to the `extras` table in `lua/tokyonight/extra/init.lua`
3. in the root directory, run `$ lua lua/tokyonight/extra/init.lua` to generate / update extra themes
4. commit the newly created themes under `extra/`