Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/yorickpeterse/nvim-grey
A light theme for NeoVim, with a light grey background
https://github.com/yorickpeterse/nvim-grey
light neovim theme vim
Last synced: 11 days ago
JSON representation
A light theme for NeoVim, with a light grey background
- Host: GitHub
- URL: https://github.com/yorickpeterse/nvim-grey
- Owner: yorickpeterse
- License: mpl-2.0
- Created: 2023-03-15T18:51:27.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-05-01T19:31:28.000Z (6 months ago)
- Last Synced: 2024-05-02T01:14:59.043Z (6 months ago)
- Topics: light, neovim, theme, vim
- Language: Lua
- Homepage:
- Size: 377 KB
- Stars: 34
- Watchers: 4
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Grey
A low-contrast theme for NeoVim, based on
[vim-paper](https://github.com/yorickpeterse/vim-paper) and written in Lua
(using `nvim_set_hl()`). Paper was the first light theme I used/created after
years of using dark themes. The rationale for that was as follows:
> I created Paper as a replacement for [Happy
> Hacking](https://github.com/yorickpeterse/happy_hacking.vim), and the
> [Autumn](https://github.com/yorickpeterse/Autumn.vim) theme it was originally
> based on. I've been using dark themes for the last decade or so, and mostly
> without issues. But dark themes are not necessarily a good choice for your eyes,
> and research has shown that it's generally better to have dark text on a light
> background (see [this StackExchange question for some interesting
> data](https://ux.stackexchange.com/questions/53264/dark-or-white-color-theme-is-better-for-the-eyes)).
> In addition, [halation](https://en.wiktionary.org/wiki/halation) becomes a
> problem when presenting light text on (very) dark backgrounds.
>
> Besides the issues with dark themes, I also simply wanted a theme with fewer
> colors; making the colors that _are_ used stand out more. I couldn't squeeze
> this into the Happy Hacking theme without fundamentally changing it, so I
> created a new theme instead.
Grey is a continuation of the goal of making a light theme that's easy on the
eyes, and not distracting by introducing many colors. The most notable
difference compared to Paper is that the main background color is a light grey,
instead of a light yellow color. Hence the (incredibly creative) name.
Like Paper, this theme is best used on a low brightness display, with a color
temperature of <5500K. During the day I use a color temperature of 5200K, while
at night the temperature is set to 3800K. This theme probably won't look so good
when using the common display temperature of 6500K.
# Screenshots
Rust:
NeoVim's terminal emulator:
Telescope (using the provided extension):
# Requirements
* NeoVim 0.7.0 or newer (due to the use of `nvim_set_hl()`)
* true-color support
For best results use `set laststatus=3` (introduced in NeoVim 0.8), as the theme
is designed with this setting in mind.
# Installation
## Vim Plug
Plug 'yorickpeterse/nvim-grey'
# Telescope extension
An extension for Telescope is included, providing a layout strategy called
"grey". It's recommended that Telescope users use this layout, as the theme
applies highlights with this layout in mind. To enable, configure Telescope like
so:
```lua
require('telescope').setup({
defaults = {
-- These three settings are optional, but recommended.
prompt_prefix = '',
entry_prefix = ' ',
selection_caret = ' ',
-- This is the important part: without this, Telescope windows will look a
-- bit odd due to how borders are highlighted.
layout_strategy = 'grey',
layout_config = {
-- The extension supports both "top" and "bottom" for the prompt.
prompt_position = 'top',
-- You can adjust these settings to your liking.
width = 0.6,
height = 0.5,
preview_width = 0.6,
},
}
})
telescope.load_extension('grey')
```
# License
All source code in this repository is licensed under the Mozilla Public License
version 2.0, unless stated otherwise. A copy of this license can be found in the
file "LICENSE".