An arctic, north-bluish clean and elegant Vim color theme.
Designed for a fluent and clear workflow.
Based on the Nord color palette.
Font: Source Code Pro 20px- [Getting started](#getting-started) - [Installation](#installation) - [Via plugin/runtimepath manager](#via-pluginruntimepath-manager) - [Manual](#manual) - [Activation](#activation) - [Configuration](#configuration) - [Italic comments](#italic-comments) - [Uniform status lines](#uniform-status-lines) - [Comment contrast](#comment-contrast) - [Uniform diff background](#uniform-diff-background) - [Plugin Support](#plugin-support) - [UI Plugins](#ui-plugins) - [Language Plugins](#language-plugins) - [JavaScript](#javascript) - [Languages](#languages) - [Development](#development) - [Contribution](#contribution) ## Getting started ### Installation **NOTE**: Nord Vim in terminal mode **MUST** be used with the associated terminal emulator theme in order to work properly! Make sure to install one of the currently supported terminal themes listed below **BEFORE** installing Nord Vim. [](https://github.com/arcticicestudio/nord-gnome-terminal) [](https://github.com/arcticicestudio/nord-guake) [](https://github.com/arcticicestudio/nord-hyper) [](https://github.com/arcticicestudio/nord-iterm2) [](https://github.com/arcticicestudio/nord-konsole) [](https://github.com/arcticicestudio/nord-mintty) [](https://github.com/arcticicestudio/nord-putty) [](https://github.com/arcticicestudio/nord-terminal-app) [](https://github.com/arcticicestudio/nord-terminator) [](https://github.com/arcticicestudio/nord-tilix) [](https://github.com/arcticicestudio/nord-termite) [](https://github.com/arcticicestudio/nord-xfce-terminal) [](https://github.com/arcticicestudio/nord-xresources) #### Via plugin/runtimepath manager I recommend to use [`vim-plug`](https://github.com/junegunn/vim-plug). Add Nord Vim to your `.vimrc` ```vim Plug 'arcticicestudio/nord-vim' ``` and install via `:PlugInstall`. You can specify the `develop` branch to install the latest development version. ```vim Plug 'arcticicestudio/nord-vim', { 'branch': 'develop' } ``` A specific version can be installed via git tags. ```vim Plug 'arcticicestudio/nord-vim', { 'tag': 'v0.6.0' } ``` Of course it can be installed with any of your favorite tools: [`pathogen`](https://github.com/tpope/vim-pathogen) ```sh cd ~/.vim/bundle git clone git://github.com/arcticicestudio/nord-vim.git ``` [`Vundle`](https://github.com/VundleVim/Vundle.vim) Add Nord Vim to your `.vimrc` ```vim Plugin 'arcticicestudio/nord-vim' ``` and install via `:PluginInstall`. #### Manual [Download](https://github.com/arcticicestudio/nord-vim/releases/latest) the latest version or clone the repository and copy the [`nord.vim`](https://github.com/arcticicestudio/nord-vim/blob/develop/colors/nord.vim) theme file to your `~/.vim/colors` directory. ### Activation Use Nord Vim as your default color theme by adding it to your `.vimrc` ```vim colorscheme nord ``` or change it on-the-fly by running `:colorscheme nord`. [`vim-plug`](https://github.com/junegunn/vim-plug) also provides options to enable it on-demand for specific languages ```vim " Activate Nord Vim when editing Java files Plug 'arcticicestudio/nord-vim', { 'for': 'java' } ``` or on specific events. ```vim " Activate Nord Vim when toggling the NERDTree Plug 'arcticicestudio/nord-vim', { 'on': 'NERDTreeToggle' } ``` ## Configuration All options should be set **before** the [activation](#activation) command! ### Italic comments **This option should only be enabled if your terminal emulator supports italics!** Enable to use italic font for all comments. To adhere to the Nord style guide this option is disabled by default. It can be enabled by setting the `g:nord_italic_comments` variable to `1`. ```vim let g:nord_italic_comments = 1 ``` ### Uniform status lines Enables uniform activate- and inactive status lines using `nord3` as background. By default, Nord Vim uses a slightly brighter background for the current split buffer. This is designed to draw attention to the currently active buffer without being distracting. If the user desires the backgrounds to be a uniform color, `g:nord_uniform_status_lines` can be set to `1`: ```vim let g:nord_uniform_status_lines = 1 ```
### Comment contrast
**This option should only be enabled if your terminal emulator supports 24bit true color (16 million colors)!**
This option is only visible if `termguicolors` is enabled in your `~/.vimrc` or set via `:set termguicolors`!
The comment brightness can be increased by 1 - 20 percent. It can be enabled by setting the `g:nord_comment_brightness`
variable to a number between `1` and `20`.
```vim
let g:nord_comment_brightness = 12
```
To adhere to the Nord style guide this option uses `nord3` by default.
More information about true color and the support in various terminals can be found in [this gist][gist-true-color].
### Uniform diff background
By default, Nord Vim provides colorful backgrounds when used in *diff* mode `vimdiff`/`vim -d`.
This can be changed to `nord1` as uniform *diff* background color by setting the `g:nord_uniform_diff_background` variable to `1`.
```vim
let g:nord_uniform_diff_background = 1
```
## Plugin Support
Nord Vim provides support for many third-party language- and UI plugins.
### UI Plugins
### Language Plugins
#### JavaScript
[`vim-javascript`](https://github.com/pangloss/vim-javascript)
Detailed descriptions for supported plugins can be found in the [project wiki](https://github.com/arcticicestudio/nord-vim/wiki).
## Languages
Nord Vim contains optimized styles to achieve a consistent and uniform coloring across languages.
Detailed descriptions for supported languages can be found in the [project wiki](https://github.com/arcticicestudio/nord-vim/wiki) and in the [Plugin Support](#plugin-support) section.
![][scrot-lang-c]
![][scrot-lang-css]
![][scrot-lang-html]
![][scrot-lang-java]
![][scrot-lang-javascript]
![][scrot-lang-json]
![][scrot-lang-markdown]
![][scrot-lang-php]
![][scrot-lang-python]
![][scrot-lang-ruby]
## Development
[](https://github.com/arcticicestudio/nord-vim/blob/v0.6.0/CHANGELOG.md) [](http://nvie.com/posts/a-successful-git-branching-model) [](https://github.com/arcticicestudio/arcver)
### Contribution
Please report issues/bugs, feature requests and suggestions for improvements to the [issue tracker](https://github.com/arcticicestudio/nord-vim/issues).
Copyright © 2017 Arctic Ice Studio
