kinoute / vim-hivacruz-theme

A dark blue Vim color scheme.

Hivacruz Vim Theme

hivacruz is a work in progress dark blue GUI color scheme for Vim and Neovim.

The font used in the screenshot is Roboto Mono Nerd Font, Medium, 12px, on iTerm2 Terminal.

Prerequisites

hivacruz is a GUI-only Vim color scheme, for now.

A GUI client, such as gvim, or a modern terminal version of Vim/Neovim with termguicolors enabled in a true-color terminal, will be required. Details about true-color terminals are listed below.

hivacruz explicitly does not support the 256 color cterm version of Vim due to the number of custom colors required. It might in the future.

If you want to know if your Terminal supports 24-bit color, run the following snippet in your shell:

printf "\x1b[38;2;255;100;0mTRUECOLOR\x1b[0m\n"

If your terminal emulator does NOT display the word TRUECOLOR in red, it does not support 24-bit color.

Installation

This theme follows the standard runtime path structure, and as such it can be installed with a variety of plugin managers:

Plugin Manager	Install with...
NeoBundle	NeoBundle 'kinoute/vim-hivacruz-theme'
Vundle	Plugin 'kinoute/vim-hivacruz-theme'
Plug	Plug 'kinoute/vim-hivacruz-theme'
Dein	call dein#add('kinoute/vim-hivacruz-theme')
minpac	call minpac#add('kinoute/vim-hivacruz-theme')
manual	Clone the repo and copy all of the files into your ~/.vim directory.

Then:

1. Run the Plugin Manager command to install plugins (like :PluginInstall for Vundle or PlugInstall for Plug) on vim after you added the correct line in .vimrc ;
2. Verify that you have enabled the syntax highlighting with syntax enable or syntax on ;
3. Add/change your colorscheme to colorscheme hivacruz in your .vimrc. Make sure this line appears after your Plugin Manager lists the plugins installed ;
4. Add set termguicolors on top of your .vimrc, otherwise the theme might not work correctly.

Languages supported

Most of the (Neo)vim languages will have syntax highlighting working out of the box.

To have a better syntax highlighting experience, I highly recommend to install the vim-polyglot plugin. This plugin adds a lot of syntax highlighting for hundreds of languages and this theme depends on it to provide a better set of colors.

Install it with your Plugin manager like this (example here with Vundle):

Plugin 'sheerun/vim-polyglot'

You can see the list of languages where additionnal syntax highlighting was applied here.

Lightline & Airline

This theme also has support for lightline as well as airline.

To enable lightline support:

let g:lightline = {'colorscheme' : 'hivacruz'}

Or to enable airline support:

let g:airline_theme = 'hivacruz'
let g:airline_powerline_fonts = 1

The lightline and airline styles will both follow the chosen colors cheme style.

Plugins explicity styled

As today, the following plugins have been styled (more to come):

• airline
• ALE
• fzf.vim
• GitGutter
• indentLine
• lightline
• NERDTree

True Color Terminals

Many modern terminals support 24-bit true colors. Current versions of Vim and Neovim on such terminals support true colors when set termguicolors is enabled.

A list of popular terminals that support true colors:

• iTerm2 (see my personal theme below)
• GNOME Terminal
• Windows Terminal
• Alacritty
• kitty
• konsole
• PuTTY
• mintty

On terminals that support true colors, and when termguicolors is set, the hivacruz color scheme will emit the correct theme colors.

For the hivacruz color scheme to display correctly inside tmux the following setting will usually be required in ~/.tmux.conf:

set -ga terminal-overrides ',xterm-256color:Tc'

Vim, as against Neovim, inside tmux, will also require the following setting be added to .vimrc:

let &t_8f = "\<Esc>[38;2;%lu;%lu;%lum"
let &t_8b = "\<Esc>[48;2;%lu;%lu;%lum"

Contributing

Since it is a work in progress, if you find something buggy or you simply want to help in order to improve the theme, please don't hesitate to submit Pull Requests or write issues!

Screenshots

Some examples of syntax highlighting:

Ruby

JavaScript

CSS

PHP

Yaml

Bash

The font used is Roboto Mono Nerd Font, Medium, 12px, on iTerm2 Terminal.

Same theme in other apps

I made similar themes with the same colors for different applications. Here there are:

• Sublime Text theme: https://github.com/kinoute/hivacruz-sublime-theme
• VSCode Theme: https://github.com/kinoute/vscode-hivacruz-theme
• iTerm2: https://github.com/kinoute/hivacruz-itermcolors
• Nova: https://github.com/kinoute/hivacruz-nova-theme
• Typora Theme: https://github.com/kinoute/typora-hivacruz-theme

Credits

• Created by Yann Defretin.
• Colors inspired by Coda 2.5's Panic Palette by Cabel Sasser.
• The README was written by using the vim-nightfly-guicolors README as a template.