farout.nvim/README.md

250 lines
8.0 KiB
Markdown
Raw Normal View History

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)
- [Scrollbar](https://github.com/petertriho/nvim-scrollbar)
- [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
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
" There are also colorschemes for the different styles
colorscheme tokyonight-night
colorscheme tokyonight-storm
colorscheme tokyonight-day
2021-04-19 19:40:12 +00:00
```
```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
> ❗️ 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
The **day** style will be used if:
2022-09-05 19:02:16 +00:00
- `{ style = "day"}` was passed to `setup(options)`
- or `vim.o.background = "light"`
2022-09-05 19:02:16 +00:00
TokyoNight will use the default options, unless you call `setup`.
2021-04-20 10:19:20 +00:00
```lua
2022-09-05 19:02:16 +00:00
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`, a darker variant `night` and `day`
transparent = false, -- Enable this to disable setting the background color
terminal_colors = true, -- Configure the colors used when opening a `:terminal` in Neovim
2022-09-05 19:02:16 +00:00
styles = {
-- Style to be applied to different syntax groups
-- Value is any valid attr-list value `:help attr-list`
comments = "italic",
keywords = "italic",
functions = "NONE",
variables = "NONE",
-- 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**.
2022-09-05 20:04:01 +00:00
dim_inactive = false, -- dims inactive windows
lualine_bold = false, -- When `true`, section headers in the lualine theme will be bold
2022-09-05 19:02:16 +00:00
--- You can override specific color groups to use other groups or a hex color
2022-09-05 19:02:16 +00:00
--- fucntion 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
2022-09-05 19:02:16 +00:00
--- fucntion will be called with a Highlights and ColorScheme table
---@param highlights Highlights
---@param colors ColorScheme
on_highlights = function(highlights, colors) end,
})
2022-09-05 19:02:16 +00:00
```
2021-04-23 18:21:12 +00:00
Example for changing some settings and colors
2022-09-05 19:02:16 +00:00
```lua
require("tokyonight").setup({
-- use the night style
style = "night",
-- disable italic for functions
styles = {
functions = "NONE"
},
sidebars = { "qf", "vista_kind", "terminal", "packer" },
-- Change the "hint" color to the "orange" color, and make the "error" color bright red
2022-09-07 16:26:55 +00:00
on_colors = function(colors)
2022-09-05 19:02:16 +00:00
colors.hint = colors.orange
colors.error = "#ff0000"
2022-09-07 16:26:55 +00:00
end
2022-09-05 19:02:16 +00:00
})
```
Example to make Telescope [borderless](https://github.com/nvim-telescope/telescope.nvim/wiki/Gallery#borderless)
```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,
})
2021-04-19 19:40:12 +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
Extra color configs for **Kitty**, **Alacritty**, **Fish**, **WezTerm**, **iTerm** and **foot** 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)
You can easily use the color palette for other plugins inside your Neovim config:
```lua
2022-09-05 19:02:16 +00:00
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.brighten(colors.red1, 0.3)
```
## 🔥 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`
2022-09-05 19:02:16 +00:00
3. in Nvim, run `:lua require("tokyonight.extra").setup()` to generate / update extra themes
4. commit the newly created themes under `extra/`