README.md

August 2, 2025 ยท View on GitHub

Introduction

Gruvbox Material is a modified version of Gruvbox, the contrast is adjusted to be softer in order to protect developers' eyes.

There are 3 palettes available in this color scheme:
Full color previews are included for your convenience

๐Ÿ‘ ๐‘ต๐’๐’•๐’†: ๐’„๐’๐’Š๐’„๐’Œ ๐’๐’ ๐’•๐’‰๐’† ๐’‡๐’๐’๐’๐’๐’˜๐’Š๐’๐’ˆ ๐’๐’Š๐’๐’†๐’” ๐’•๐’ ๐’‘๐’“๐’†๐’—๐’Š๐’†๐’˜

material: Carefully designed to have a soft contrast
๐ƒ๐š๐ซ๐ค๐‹๐ข๐ ๐ก๐ญ
๐‡๐š๐ซ๐material-hard-dark material-hard-darkmaterial-hard-light material-hard-light
๐Œ๐ž๐๐ข๐ฎ๐ฆmaterial-medium-dark material-medium-darkmaterial-medium-light material-medium-light
๐’๐จ๐Ÿ๐ญmaterial-soft-dark material-soft-darkmaterial-soft-light material-soft-light
mix: Color palette obtained by calculating the mean of the other two
๐ƒ๐š๐ซ๐ค๐‹๐ข๐ ๐ก๐ญ
๐‡๐š๐ซ๐mix-hard-dark mix-hard-darkmix-hard-light mix-hard-light
๐Œ๐ž๐๐ข๐ฎ๐ฆmix-medium-dark mix-medium-darkmix-medium-light mix-medium-light
๐’๐จ๐Ÿ๐ญmix-soft-dark mix-soft-darkmix-soft-light mix-soft-light
original: The color palette used in the original gruvbox
๐ƒ๐š๐ซ๐ค๐‹๐ข๐ ๐ก๐ญ
๐‡๐š๐ซ๐original-hard-dark original-hard-darkoriginal-hard-light original-hard-light
๐Œ๐ž๐๐ข๐ฎ๐ฆoriginal-medium-dark original-medium-darkoriginal-medium-light original-medium-light
๐’๐จ๐Ÿ๐ญoriginal-soft-dark original-soft-darkoriginal-soft-light original-soft-light

This color scheme uses the material palette by default, you can use a global variable to switch to another palette.

Features

  • Carefully designed color palette for eye protection.
  • Switch back to the original color palette whenever you like.
  • Highly customizable.
  • Rich support for common file types and plugins.
  • Tree-sitter support.
  • Semantic highlighting support.
  • Italic support ๐ŸŽ‰

Documentation

See :help gruvbox-material.txt

See this wiki page.

Contributing

See this post.

More Color Schemes

Credits

Inspirations

Maintainers

Sainnhe ParkZixin YinAntoine Cotten
Sainnhe ParkZixin YinAntoine Cotten

License

MIT ยฉ sainnhe