/github-nvim-theme

Github's Neovim themes

Primary LanguageLuaMIT LicenseMIT

github-nvim-theme

Notices

shoutout-sponsors

Note All features and bug fixes are on hold while we focus on a refactor of the theme. If you would like to be involved in the discussion or have input to share, please join us as soon as possible. Thank you for your understanding.

Subscribe to this discussion or :h github-theme-changelog to receive updates on breaking changes and deprecations.

  • 2022-08-03: Terminal and other themes have been moved to github-theme-contrib git repository and related code have been removed from this repository.

Requirements

  • Neovim >= 0.5.0

Installation

Warning Use the latest release tag or 0.0.x branch for updates, not the main branch.

Install the theme with your preferred package manager:

Install with vim-plug:

Plug 'projekt0n/github-nvim-theme', { 'tag': 'v0.0.7' }
" or                                { 'branch': '0.0.x' }

Or with dein:

call dein#add('projekt0n/github-nvim-theme', { 'rev': 'v0.0.7' })
" or                                         { 'rev': '0.0.x' }

Or with minpac:

call minpac#add('projekt0n/github-nvim-theme', { 'rev': 'v0.0.7' })
" or                                           { 'rev': '0.0.x' }

Or with Packer.nvim:

Add this in your init.lua or plugins.lua

-- Install without configuration
use ({ 'projekt0n/github-nvim-theme', tag = 'v0.0.7' })
-- or                                 branch = '0.0.x'

-- Or with configuration
use({
  'projekt0n/github-nvim-theme', tag = 'v0.0.7',
-- or                            branch = '0.0.x'
  config = function()
    require('github-theme').setup({
      -- ...
    })
  end
})

Usage

Enable the colorscheme:

" Vim Script
colorscheme github_*
-- Lua
require('github-theme').setup()

Configuration

Option Default Description
colors {} You can override specific color groups to use other groups or a hex color
comment_style italic Highlight style for comments (check :help highlight-args for options)
dark_float false Float windows like the lsp diagnostics windows get a darker background.
dark_sidebar true Sidebar like windows like NvimTree get a darker background
dev false Developer Mode.
function_style NONE Highlight style for functions (check :help highlight-args for options)
hide_end_of_buffer true Enabling this option, will hide filler lines (~) after the end of the buffer
hide_inactive_statusline true Enabling this option, will hide inactive statuslines and replace them with a thin border instead. Should work with the standard StatusLine.
keyword_style italic Highlight style for keywords (check :help highlight-args for options)
msg_area_style NONE Highlight style for messages and cmdline (check :help highlight-args for options)
overrides function Override specific highlight groups. The function accpet colors as argument. You can also add a non-exists highlight by enabling the dev mode.
sidebars {} Set a darker background on sidebar-like windows. For example: {"qf", "vista_kind", "terminal", "packer"}
theme_style dark Set theme variant (options: dark/dimmed/dark_default/dark_colorblind/light/light_default/light_colorblind)
transparent false Enable this to disable setting the background color
variable_style NONE Highlight style for variables and identifiers (check :help highlight-args for options)

Using vim

" Example config in VimScript
" NOTE: Configuration needs to be set BEFORE loading the color scheme with `colorscheme` command
let g:github_function_style = "italic"
let g:github_sidebars = ["qf", "vista_kind", "terminal", "packer"]

" Change the "hint" color to the "orange" color, and make the "error" color bright red
let g:github_colors = {
  \ 'hint': 'orange',
  \ 'error': '#ff0000'
\ }

" Load the colorscheme
colorscheme github_dark

Using lua

-- Example config in Lua
require("github-theme").setup({
  theme_style = "dark",
  function_style = "italic",
  sidebars = {"qf", "vista_kind", "terminal", "packer"},

  -- Change the "hint" color to the "orange" color, and make the "error" color bright red
  colors = {hint = "orange", error = "#ff0000"},

  -- Overwrite the highlight groups
  overrides = function(c)
    return {
      htmlTag = {fg = c.red, bg = "#282c34", sp = c.hint, style = "underline"},
      DiagnosticHint = {link = "LspDiagnosticsDefaultHint"},
      -- this will remove the highlight groups
      TSField = {},
    }
  end
})

Features

Lualine Support

Installation docs and screenshots at LUALINE.md.

Terminal Themes

Moved to projekt0n/github-theme-contrib git repository

Making undercurls work properly in Tmux

To have undercurls show up and in color, add the following to your Tmux config file:

# 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

Screenshots

Theme Styles

Dark

" VimScript
colorscheme github_dark
-- Lua
require("github-theme").setup({
  theme_style = "dark",
  -- other config
})

github_dark

Dimmed

" VimScript
colorscheme github_dimmed
-- Lua
require("github-theme").setup({
  theme_style = "dimmed",
  -- other config
})

github_dimmed

Dark Default

" VimScript
colorscheme github_dark_default
-- Lua
require("github-theme").setup({
  theme_style = "dark_default",
  -- other config
})

github_dark_default

Dark Colorblind (Beta)

" VimScript
colorscheme github_dark_colorblind
-- Lua
require("github-theme").setup({
  theme_style = "dark_colorblind",
  -- other config
})

github_dark_colorblind

Light

" VimScript
colorscheme github_light
-- Lua
require("github-theme").setup({
  theme_style = "light",
  -- other config
})

github_light

Light Default

" VimScript
colorscheme github_light_default
-- Lua
require("github-theme").setup({
  theme_style = "light_default",
  -- other config
})

github_light_default

Light Colorblind (Beta)

" VimScript
colorscheme github_light_colorblind
-- Lua
require("github-theme").setup({
  theme_style = "light_colorblind",
  -- other config
})

github_light_colorblind

Syntax Styles

Default

github_default_syntax

Normal

" VimScript
let g:github_comment_style = "NONE"
let g:github_keyword_style = "NONE"
let g:github_function_style = "NONE"
let g:github_variable_style = "NONE"
-- Lua
require("github-theme").setup({
  comment_style = "NONE",
  keyword_style = "NONE",
  function_style = "NONE",
  variable_style = "NONE"
  -- other config
})

github_normal_syntax

Italic

" VimScript
let g:github_comment_style = "italic"
let g:github_keyword_style = "italic"
let g:github_function_style = "italic"
let g:github_variable_style = "italic"
-- Lua
require("github-theme").setup({
  comment_style = "italic",
  keyword_style = "italic",
  function_style = "italic",
  variable_style = "italic"
  -- other config
})

github_italic_syntax

Minimal config

" VimScript
let g:github_dark_sidebar = 0
-- Lua
require("github-theme").setup({
  dark_sidebar = false,
  -- other config
})

github_minimal

Telescope

github_telescope

Contributing

See CONTRIBUTING.md

Copying

This project is released under the terms of the MIT license. See LICENCE for more information or see opensource.org