ctrl+shift+p filters: :st2 :st3 :win :osx :linux
Browse

gruvbox

by Briles ST3

Sublime Text themes & color schemes with pastel 'retro groove' colors

Details

Installs

  • Total 6K
  • Win 2K
  • OS X 2K
  • Linux 2K
Nov 23 Nov 22 Nov 21 Nov 20 Nov 19 Nov 18 Nov 17 Nov 16 Nov 15 Nov 14 Nov 13 Nov 12 Nov 11 Nov 10 Nov 9 Nov 8 Nov 7 Nov 6 Nov 5 Nov 4 Nov 3 Nov 2 Nov 1 Oct 31 Oct 30 Oct 29 Oct 28 Oct 27 Oct 26 Oct 25 Oct 24 Oct 23 Oct 22 Oct 21 Oct 20 Oct 19 Oct 18 Oct 17 Oct 16 Oct 15 Oct 14 Oct 13 Oct 12 Oct 11 Oct 10 Oct 9
Windows 0 5 4 7 3 5 7 6 3 2 6 1 4 5 8 1 2 3 2 2 4 7 5 4 7 4 1 4 3 6 5 4 4 4 1 2 8 5 7 9 2 4 10 4 4 4
OS X 1 1 3 0 4 3 4 4 2 2 1 6 2 4 4 1 2 5 2 3 9 4 2 3 5 5 5 3 2 4 5 4 4 4 2 5 4 3 6 5 7 2 5 2 3 2
Linux 4 4 5 5 8 2 9 2 6 3 5 6 6 2 5 3 7 2 4 2 4 7 3 5 4 1 4 5 2 8 3 4 4 6 0 5 5 4 7 2 8 5 4 2 3 5

Readme

Source
raw.​githubusercontent.​com

GitHub Tag Package Control Build Status

gruvbox for Sublime Text

Based on gruvbox for Vim

Screenshot DarkScreenshot Light

Contrast options

Screenshot Contrast Options

Installation

Package Control

The easiest way to install is using Package Control

  1. Open Command Palette using menu item Tools -> Command Palette... (P on Mac) (ctrlshiftP on Windows)
  2. Choose Package Control: Install Package
  3. Find gruvbox and hit Enter
  4. Activate the theme by adding the code below to Preferences > Setting - User:
  5. Restart Sublime Text

Manual

You can also install the theme manually:

  1. Download the .zip
  2. Unzip and rename the folder to gruvbox
  3. Copy the folder into Packages directory, which you can find using the menu item Sublime Text -> Preferences -> Browse Packages...
  4. Activate the theme by adding the code below to Preferences > Setting - User:
  5. Restart Sublime Text

How to Activate

Activate the UI theme and color scheme by modifying your user preferences file, which you can find using the menu item Sublime Text -> Preferences -> Settings - User (, on Mac).

Note: Don't forget to restart Sublime Text after activating the theme.

// gruvbox Dark Hard Contrast
{
  "theme": "gruvbox (Dark) (Hard).sublime-theme",
  "color_scheme": "Packages/gruvbox/gruvbox (Dark) (Hard).tmTheme",
}
// gruvbox Dark Medium Contrast
{
  "theme": "gruvbox (Dark) (Medium).sublime-theme",
  "color_scheme": "Packages/gruvbox/gruvbox (Dark) (Medium).tmTheme",
}
// gruvbox Dark Soft Contrast
{
  "theme": "gruvbox (Dark) (Soft).sublime-theme",
  "color_scheme": "Packages/gruvbox/gruvbox (Dark) (Soft).tmTheme",
}
// gruvbox Light Hard Contrast
{
  "theme": "gruvbox (Light) (Hard).sublime-theme",
  "color_scheme": "Packages/gruvbox/gruvbox (Light) (Hard).tmTheme",
}
// gruvbox Light Medium Contrast
{
  "theme": "gruvbox (Light) (Medium).sublime-theme",
  "color_scheme": "Packages/gruvbox/gruvbox (Light) (Medium).tmTheme",
}
// gruvbox Light Soft Contrast
{
  "theme": "gruvbox (Light) (Soft).sublime-theme",
  "color_scheme": "Packages/gruvbox/gruvbox (Light) (Soft).tmTheme",
}

Color Scheme Variations

gruvbox comes with color scheme variations which have different brightness, saturation, or colors than their parent color schemes while still maintaining that excellent gruvbox tone.

No Dimmed Colors

A variant without out any neutral / dimmed colors

"color_scheme": "Packages/gruvbox/gruvbox (Dark) (Hard) NDC.tmTheme",
"color_scheme": "Packages/gruvbox/gruvbox (Dark) (Medium) NDC.tmTheme",
"color_scheme": "Packages/gruvbox/gruvbox (Dark) (Soft) NDC.tmTheme",
"color_scheme": "Packages/gruvbox/gruvbox (Light) (Hard) NDC.tmTheme",
"color_scheme": "Packages/gruvbox/gruvbox (Light) (Medium) NDC.tmTheme",
"color_scheme": "Packages/gruvbox/gruvbox (Light) (Soft) NDC.tmTheme",

Configuration

Accent Colors

Accent Colors

Accent colors affect icons and certain text.

"gruvbox_accent_aqua": true,
  "gruvbox_accent_blue": true,
  "gruvbox_accent_green": true,
  "gruvbox_accent_orange": true,
  "gruvbox_accent_purple": true,
  "gruvbox_accent_red": true,
  "gruvbox_accent_yellow": true,

  "gruvbox_accent_opposite": true, // Use the other mode's accent color; IE: Use Light theme's red with Dark theme
  "gruvbox_accent_neutral": true, // Use brightness-mode-neutral accent color

AutoComplete Spacing

Change the space between autocomplete rows

// sizes are top/bottom in px
  "gruvbox_autocomplete_cramped": true,      //  v  2
  "gruvbox_autocomplete_compact": true,      //  |  4
                                             //  |  6 (Default)
  "gruvbox_autocomplete_comfortable": true,  //  |  8
  "gruvbox_autocomplete_cozy": true,         //  v  10

AutoComplete Border

Add a border around the autocomplete popup

"gruvbox_autocomplete_border": true,
  "gruvbox_autocomplete_border_thick": true,

Sideline Selected AutoComplete Row

Add a border to the left of the selected autocomplete row

All thicknesses require gruvbox_sideline_autocomplete_row to be true.

"gruvbox_sideline_autocomplete_row": true,           //  v  1 (Default)
  "gruvbox_sideline_autocomplete_row_thick": true,     //  |  2
  "gruvbox_sideline_autocomplete_row_thickest": true,  //  v  3

Disable Selected AutoComplete Row Highlight

Remove the highlight from the selected autocomplete row.

"gruvbox_disable_autocomplete_row_highlight": true,

Sidebar Spacing

Change the space between sidebar tree rows

// sizes are top/bottom in px
  "gruvbox_sidebar_cozy": true,         //  v  1
  "gruvbox_sidebar_comfortable": true,  //  |  3
                                        //  |  5 (Default)
  "gruvbox_sidebar_compact": true,      //  |  7
  "gruvbox_sidebar_cramped": true,      //  v  9

Sidebar Indent

Change the indent of sidebar tree rows

"gruvbox_sidebar_indent_xxs": true,  //  v  4
  "gruvbox_sidebar_indent_xs": true,   //  |  8
  "gruvbox_sidebar_indent_s": true,    //  |  12
                                       //  |  16 (Default)
  "gruvbox_sidebar_indent_l": true,    //  |  20
  "gruvbox_sidebar_indent_xl": true,   //  |  24
  "gruvbox_sidebar_indent_xxl": true,  //  v  28

Sidebar Font Sizes

Change the font size of the sidebar labels

Increasing the font size will distort the icons in the sidebar.

"gruvbox_sidebar_font_size_10": true,  //  v  10
                                         //  |  11 (Default)
  "gruvbox_sidebar_font_size_12": true,  //  |  12
  "gruvbox_sidebar_font_size_13": true,  //  |  13
  "gruvbox_sidebar_font_size_14": true,  //  |  14
  "gruvbox_sidebar_font_size_15": true,  //  |  15
  "gruvbox_sidebar_font_size_16": true,  //  v  16

Command Palette Spacing

Change the space between command palette rows

// sizes are top/bottom in px
  "gruvbox_command_palette_comfortable": true,  //  v  4
  "gruvbox_command_palette_compact": true,      //  |  8
                                                //  |  12 (Default)
  "gruvbox_command_palette_cozy": true,         //  |  14
  "gruvbox_command_palette_cramped": true,      //  v  16

Sideline Selected Command Palette Row

Add a border to the left of the selected Command Palette row

All thicknesses require gruvbox_sideline_command_palette_row to be true.

"gruvbox_sideline_command_palette_row": true,           //  v  1 (Default)
  "gruvbox_sideline_command_palette_row_thick": true,     //  |  2
  "gruvbox_sideline_command_palette_row_thickest": true,  //  v  3

Disable Selected Command Palette Row Highlight

Remove the highlight from the selected Command Palette row.

"gruvbox_disable_command_palette_row_highlight": true,

Statusbar Sizes

Change the height of the statusbar

// sizes are in px
  "gruvbox_statusbar_xxs": true,  //  v  20
  "gruvbox_statusbar_xs": true,   //  |  25
  "gruvbox_statusbar_s": true,    //  |  30
                                  //  |  35 (Default)
  "gruvbox_statusbar_l": true,    //  |  40
  "gruvbox_statusbar_xl": true,   //  |  45
  "gruvbox_statusbar_xxl": true,  //  v  50

Statusbar Button Widths

Change the minimum width of the buttons in the statusbar

// sizes are in px
  "gruvbox_statusbar_button_xxs": true,  //  v  44
  "gruvbox_statusbar_button_xs": true,   //  |  55
  "gruvbox_statusbar_button_s": true,    //  |  65
                                         //  |  75 (Default)
  "gruvbox_statusbar_button_l": true,    //  |  85
  "gruvbox_statusbar_button_xl": true,   //  |  95
  "gruvbox_statusbar_button_xxl": true,  //  v  105

Statusbar Font Sizes

Change the font size of the status bar labels

"gruvbox_statusbar_font_size_10": true,  //  v  10
                                           //  |  11 (Default)
  "gruvbox_statusbar_font_size_12": true,  //  |  12
  "gruvbox_statusbar_font_size_13": true,  //  |  13
  "gruvbox_statusbar_font_size_14": true,  //  |  14
  "gruvbox_statusbar_font_size_15": true,  //  |  15
  "gruvbox_statusbar_font_size_16": true,  //  v  16

Tab Sizes

Change the height of the tabs

// sizes are in px
  "gruvbox_tabs_xxs": true,  //  v  33
  "gruvbox_tabs_xs": true,   //  |  39
  "gruvbox_tabs_s": true,    //  |  45
                             //  |  51 (Default)
  "gruvbox_tabs_l": true,    //  |  57
  "gruvbox_tabs_xl": true,   //  |  63
  "gruvbox_tabs_xxl": true,  //  v  69

Tab Font Sizes

Change the font size of the tabs

Font sizes above 11 may get cut off. This is a known issue with Sublime Text.

"gruvbox_tabs_font_size_7": true,   //  v  7
  "gruvbox_tabs_font_size_8": true,   //  |  8
  "gruvbox_tabs_font_size_9": true,   //  |  9
  "gruvbox_tabs_font_size_10": true,  //  |  10
                                      //  |  11 (Default)
  "gruvbox_tabs_font_size_12": true,  //  |  12
  "gruvbox_tabs_font_size_13": true,  //  |  13
  "gruvbox_tabs_font_size_14": true,  //  |  14
  "gruvbox_tabs_font_size_15": true,  //  v  15

Autocollapsing Tab Bar

Autocollapse the tabs when not in use

"gruvbox_autocollapse_tabs": true,            // enable the autocollapsing tabs

  // Set the height of the trigger area which shows the tabs
  "gruvbox_autocollapse_tabs_trigger_2": true,  //  v  2
  "gruvbox_autocollapse_tabs_trigger_3": true,  //  |  3
                                                //  |  4 (Default)
  "gruvbox_autocollapse_tabs_trigger_5": true,  //  |  5
  "gruvbox_autocollapse_tabs_trigger_6": true,  //  v  6

Underline Modified Tabs

Underline modified tabs with the current accent color

All thicknesses require gruvbox_underline_modified_tabs to be true.

"gruvbox_underline_modified_tabs": true,        //  |  1 (Default)
  "gruvbox_underline_modified_tabs_thick": true,  //  v  2

Underline Active Tab

Underline the active tab with the current accent color

All thicknesses require gruvbox_underline_active_tab to be true.

"gruvbox_underline_active_tab": true,          //  |  1 (Default)
  "gruvbox_underline_active_tab_thick": true,    //  |  2
  "gruvbox_underline_active_tab_thicker": true,  //  v  3

Find, Replace, and Console Sizes

Adjust the top & bottom margins of the Find, Replace, and Console panels

"gruvbox_panel_xxs": true,  //  v  2
  "gruvbox_panel_xs": true,   //  |  4
  "gruvbox_panel_s": true,    //  |  8
                              //  |  11 (Default)
  "gruvbox_panel_l": true,    //  |  13
  "gruvbox_panel_xl": true,   //  |  15
  "gruvbox_panel_xxl": true,  //  v  17

Scrollbar Widths

Adjust the width of the scrollbars

// sizes are total width in px
  "gruvbox_scrollbar_width_xs": true,  //  v  12
  "gruvbox_scrollbar_width_s": true,   //  |  14
                                       //  |  16 (Default)
  "gruvbox_scrollbar_width_l": true,   //  |  18
  "gruvbox_scrollbar_width_xl": true,  //  v  20

Button Font Sizes

Adjust the font size of the buttons

"gruvbox_buttons_font_size_10": true,  //  v  10
                                         //  |  11 (Default)
  "gruvbox_buttons_font_size_12": true,  //  |  12
  "gruvbox_buttons_font_size_13": true,  //  |  13
  "gruvbox_buttons_font_size_14": true,  //  |  14
  "gruvbox_buttons_font_size_15": true,  //  |  15
  "gruvbox_buttons_font_size_16": true,  //  v  16

Disable/Enable Borders

"gruvbox_disable_borders": true,                     // Disable all borders
  "gruvbox_enable_pane_borders": true,                 // Enable borders between panes
  "gruvbox_enable_sidebar_border": true,               // Enable the sidebar border
  "gruvbox_enable_statusbar_border": true,             // Enable borders for the status bar
  "gruvbox_enable_tab_borders": true,                  // Enable borders for the tabs
  "gruvbox_disable_command_palette_row_border": true,  // Disable Command Palette row borders

Alternate Folder Icons

Larger Default Folder Icons

Use larger default folder icons in the sidebar

"gruvbox_folder_icons_large": true,

Square Folder Icons

Square Folder Icons

Use square folder icons in the sidebar

"gruvbox_folder_icons_square": true,

Circle Folder Icons

Circle Folder Icons

Use 'circle' folder icons in the sidebar

"gruvbox_folder_icons_circle": true,

Plus/Minus Folder Icons

Plus Minus Folder Icons

Use 'plus/minus' folder icons in the sidebar

"gruvbox_folder_icons_plus_minus": true,

Spacegray Folder Icons

Use spacegray-like folder icons in the sidebar

"gruvbox_folder_icons_spacegray": true,

Alternate Icon Sets

Midstroke

Midstroke Icon Set

Use icons with a 1.5x thicker stroke

"gruvbox_iconset_midstroke": true,

Thick

Thick Icon Set

Use icons with a 2x thicker stroke

"gruvbox_iconset_thick": true,

Spacegray

Spacegray Icon Set

Use spacegray-like icons

"gruvbox_iconset_spacegray": true,

PlainTasks Support

PlainTasks Support

To use the color scheme with the Plain​Tasks plugin, add the color scheme path to the "color_scheme" key in Preferences > Package Settings > PlainTasks > Settings - User like so:

// PlainTasks.sublime-settings

{
  "color_scheme": "Packages/gruvbox/gruvbox (Dark) (Medium).tmTheme",
}

Even More Settings…

Even More Settings…

"gruvbox_animate_icons": true,              // Enable icon animations
  "gruvbox_buttons_bold": true,               // Enable bold button labels
  "gruvbox_colored_tooltips": true,           // Color the tooltip backgrounds with the current accent color
  "gruvbox_disable_faded_file_icons": true,   // Make file-type icons opaque
  "gruvbox_disable_file_icons": true,         // Disable the sidebar file icons
  "gruvbox_disable_folder_icons": true,       // Disable the sidebar folder icons
  "gruvbox_disable_greyscale": true,          // Use gruvbox colors instead of greyscale colors for certain text
  "gruvbox_disable_panels_button": true,      // Hide the panel-switching button
  "gruvbox_enable_panel_close_button": true,  // Enable the panel close button
  "gruvbox_highlight_active_buttons": true,   // Highlight selected buttons in the Find & Replace panel
  "gruvbox_highlight_active_tree_row": true,  // Highlight the active file in the sidebar tree
  "gruvbox_less_contrast": true,              // Use less contrasting colors in sidebar, tabs, etc.
  "gruvbox_statusbar_bold": true,             // Enable bold status bar labels
  "gruvbox_tabs_autowidth": true,             // Auto-size the tabs
  "gruvbox_tabs_bold": true,                  // Enable bold tabs

Extras

All extras can be found in the extras sub-directory of the package.

App Icons

App icons in PNG, ICO, & ICNS format are located in extras/app-icons/.

SublimeLinter Gutter Theme

Activation

  1. Add the gruvbox directory from extras/sublimelinter gutter-themes/ to Sublime Text/Data/Packages/SublimeLinter/gutter-themes/
  2. Set gruvbox as the gutter theme by choosing SublimeLinter: Choose Gutter Theme from the command palette and selecting gruvbox or by changing "gutter_theme" to "Packages/SublimeLinter/gutter-themes/gruvbox/gruvbox.gutter-theme" in SublimeLinter.sublime-settings
  3. Restart Sublime Text

Bracket Highlighter Icons

Activation

Bracket Highlighter Icons

  1. Move all images in extras/BracketHighlighter/icons/ to Sublime Text/Data/Packages/BracketHighlighter/icons/
  2. Restart Sublime Text

Code Fold Icon

Activation

Code Fold Icons

  1. Rename any *_fold.png in extras to fold.png
  2. Add the newly renamed fold.png icon to Sublime Text/Data/Packages/Theme - Default/
  3. Restart Sublime Text

Bookmark Icon

Activation

Bookmark Icons

  1. Rename any *_bookmark_*.png in extras to bookmark.png
  2. Add the newly renamed bookmark.png icon to Sublime Text/Data/Packages/Theme - Default/
  3. Restart Sublime Text


Palette

Dark mode

Palette Dark

Light mode

Palette Light


License

MIT

Contributing

Contributions are always welcome. Before contributing please read CONTRIBUTING.md.

For Other Editors

Thanks

Thanks to: