{"id":16987239,"url":"https://github.com/yorickpeterse/nvim-grey","last_synced_at":"2025-06-30T03:35:04.823Z","repository":{"id":183258121,"uuid":"614520307","full_name":"yorickpeterse/nvim-grey","owner":"yorickpeterse","description":"A light theme for NeoVim, with a light grey background","archived":false,"fork":false,"pushed_at":"2024-05-01T19:31:28.000Z","size":386,"stargazers_count":34,"open_issues_count":0,"forks_count":2,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-05-02T01:14:59.043Z","etag":null,"topics":["light","neovim","theme","vim"],"latest_commit_sha":null,"homepage":"","language":"Lua","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yorickpeterse.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-03-15T18:51:27.000Z","updated_at":"2024-05-03T01:25:53.471Z","dependencies_parsed_at":"2023-11-07T04:59:06.910Z","dependency_job_id":"427f57bc-0462-48b7-a7f6-672a2e921a82","html_url":"https://github.com/yorickpeterse/nvim-grey","commit_stats":null,"previous_names":["yorickpeterse/nvim-grey"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yorickpeterse%2Fnvim-grey","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yorickpeterse%2Fnvim-grey/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yorickpeterse%2Fnvim-grey/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yorickpeterse%2Fnvim-grey/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yorickpeterse","download_url":"https://codeload.github.com/yorickpeterse/nvim-grey/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243858145,"owners_count":20359253,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["light","neovim","theme","vim"],"created_at":"2024-10-14T02:48:42.922Z","updated_at":"2025-03-17T09:30:32.734Z","avatar_url":"https://github.com/yorickpeterse.png","language":"Lua","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Grey\n\nA low-contrast theme for NeoVim, based on\n[vim-paper](https://github.com/yorickpeterse/vim-paper) and written in Lua\n(using `nvim_set_hl()`). Paper was the first light theme I used/created after\nyears of using dark themes. The rationale for that was as follows:\n\n\u003e I created Paper as a replacement for [Happy\n\u003e Hacking](https://github.com/yorickpeterse/happy_hacking.vim), and the\n\u003e [Autumn](https://github.com/yorickpeterse/Autumn.vim) theme it was originally\n\u003e based on. I've been using dark themes for the last decade or so, and mostly\n\u003e without issues. But dark themes are not necessarily a good choice for your eyes,\n\u003e and research has shown that it's generally better to have dark text on a light\n\u003e background (see [this StackExchange question for some interesting\n\u003e data](https://ux.stackexchange.com/questions/53264/dark-or-white-color-theme-is-better-for-the-eyes)).\n\u003e In addition, [halation](https://en.wiktionary.org/wiki/halation) becomes a\n\u003e problem when presenting light text on (very) dark backgrounds.\n\u003e\n\u003e Besides the issues with dark themes, I also simply wanted a theme with fewer\n\u003e colors; making the colors that _are_ used stand out more. I couldn't squeeze\n\u003e this into the Happy Hacking theme without fundamentally changing it, so I\n\u003e created a new theme instead.\n\nGrey is a continuation of the goal of making a light theme that's easy on the\neyes, and not distracting by introducing many colors. The most notable\ndifference compared to Paper is that the main background color is a light grey,\ninstead of a light yellow color. Hence the (incredibly creative) name.\n\nLike Paper, this theme is best used on a low brightness display, with a color\ntemperature of \u003c5500K. During the day I use a color temperature of 5200K, while\nat night the temperature is set to 3800K. This theme probably won't look so good\nwhen using the common display temperature of 6500K.\n\n# Screenshots\n\nRust:\n\n![Rust](https://github.com/yorickpeterse/nvim-grey/assets/86065/5ae636a8-92e9-4c15-ac91-959575d7f66c)\n\nNeoVim's terminal emulator:\n\n![Terminal](https://github.com/yorickpeterse/nvim-grey/assets/86065/30256cee-aba3-46bc-ab80-8d2c4da29c50)\n\nTelescope (using the provided extension):\n\n![Telescope](https://github.com/yorickpeterse/nvim-grey/assets/86065/9e2165be-9786-41f3-935d-88c9eed90f7f)\n\n# Requirements\n\n* NeoVim 0.7.0 or newer (due to the use of `nvim_set_hl()`)\n* true-color support\n\nFor best results use `set laststatus=3` (introduced in NeoVim 0.8), as the theme\nis designed with this setting in mind.\n\n# Installation\n\n## Vim Plug\n\n    Plug 'yorickpeterse/nvim-grey'\n\n# Telescope extension\n\nAn extension for Telescope is included, providing a layout strategy called\n\"grey\". It's recommended that Telescope users use this layout, as the theme\napplies highlights with this layout in mind. To enable, configure Telescope like\nso:\n\n```lua\nrequire('telescope').setup({\n  defaults = {\n    -- These three settings are optional, but recommended.\n    prompt_prefix = '',\n    entry_prefix = ' ',\n    selection_caret = ' ',\n\n    -- This is the important part: without this, Telescope windows will look a\n    -- bit odd due to how borders are highlighted.\n    layout_strategy = 'grey',\n    layout_config = {\n     -- The extension supports both \"top\" and \"bottom\" for the prompt.\n      prompt_position = 'top',\n\n      -- You can adjust these settings to your liking.\n      width = 0.6,\n      height = 0.5,\n      preview_width = 0.6,\n    },\n  }\n})\n\ntelescope.load_extension('grey')\n```\n\n# License\n\nAll source code in this repository is licensed under the Mozilla Public License\nversion 2.0, unless stated otherwise. A copy of this license can be found in the\nfile \"LICENSE\".\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyorickpeterse%2Fnvim-grey","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyorickpeterse%2Fnvim-grey","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyorickpeterse%2Fnvim-grey/lists"}