/Spacegray

A Hyperminimal UI Theme for Sublime Text

Primary LanguageJavaScriptMIT LicenseMIT

Spacegray

A set of custom UI themes for Sublime Text. It's all about hype and minimal. Comes in different flavors with accompanying Base16 color schemes.

Themes

Spacegray

Default flavor based on Base16 Ocean Dark color scheme.

image

Spacegray Light

Light variation based on Base16 Ocean Light color scheme.

image

Spacegray Eighties

A variation based on Base16 Eighties Dark color scheme.

image

Spacegray Mocha

A variation based on Base16 Mocha Dark color scheme.

image

Spacegray Oceanic

A variation based on Base16 Oceanic Dark color scheme.

image

The font used in the screenshots is Cascadia Code.


Installation

Via Package Control

The easiest way to install is using Sublime Package Control, where Spacegray is listed as Theme - Spacegray.

  1. Open Command Palette using menu item Tools > Command Palette... (P on Mac)
  2. Choose Package Control: Install Package
  3. Find Theme - Spacegray and hit Enter

Manual

You can also install the theme manually:

  1. Download the .zip
  2. Unzip and rename the folder to Theme - Spacegray
  3. Copy the folder into Packages directory, which you can find using the menu item Sublime Text -> Preferences -> Browse Packages...

Activate Theme

To select a theme call UI: Select Theme from Command Palette.

To select a color scheme call UI: Select Color Scheme from Command Palette.

Alternatively ajdust Preferences.sublime-settings by calling Preferences: Settings from Command Palette to one of the following pairs.

Settings for Spacegray

{
  "theme": "Spacegray.sublime-theme",
  "color_scheme": "Base16 Ocean Dark.sublime-color-scheme"
}

Settings for Spacegray Light

{
  "theme": "Spacegray Light.sublime-theme",
  "color_scheme": "Base16 Ocean Light.sublime-color-scheme"
}

Settings for Spacegray Eighties

{
  "theme": "Spacegray Eighties.sublime-theme",
  "color_scheme": "Base16 Eighties Dark.sublime-color-scheme"
}

Settings for Spacegray Mocha

{
  "theme": "Spacegray Mocha.sublime-theme",
  "color_scheme": "Base16 Mocha Dark.sublime-color-scheme"
}

Settings for Spacegray Oceanic

{
  "theme": "Spacegray Oceanic.sublime-theme",
  "color_scheme": "Base16 Oceanic.sublime-color-scheme"
}

Theme Customization

Themes are customized either by adjusting predefined settings or by modifying global theme variables or rules.

Open Command Palette and call one of:

  1. Preferences: Settings
  2. UI: Customize Theme

Theme Variables

Font Face

Global font face is set to "system".

To customize font face,

  1. open Command Palette
  2. call UI: Customize Theme
  3. modify "font_face" variable

Font Size

Global font size is derived from Preferences.sublime-settings > "font_size" by default.

To customize font size,

  1. open Command Palette
  2. call UI: Customize Theme
  3. modify "font_size" variable

Global Theme Settings

To customize theme settings,

  1. open Command Palette
  2. call Preferences: Settings

Themed Title Bar

Useful if you're using native OSX tabs since custom title bar breaks the native tabs.

  "themed_title_bar": false,

Tabs Navigation Icons

  "enable_tab_scrolling": false,

Tabs Close Buttons

Hide tab close buttons:

  "show_tab_close_buttons": false,

Display tab close buttons on the left:

  "show_tab_close_buttons_on_left": true,

Spacegray Theme Settings

To customize theme settings,

  1. open Command Palette
  2. call Preferences: Settings

Tabs Size

Tabs height:

  "theme.spacegray.tabs.height": "small"
  "theme.spacegray.tabs.height": "normal"
  "theme.spacegray.tabs.height": "large"
  "theme.spacegray.tabs.height": "xlarge"

Tabs width:

  "theme.spacegray.tabs.auto_width": true

Sidebar Tree Row Height

  "theme.spacegray.sidebar.row_height": "xsmall"
  "theme.spacegray.sidebar.row_height": "small"
  "theme.spacegray.sidebar.row_height": "normal"
  "theme.spacegray.sidebar.row_height": "large"
  "theme.spacegray.sidebar.row_height": "xlarge"

Sidebar File Icons

  "theme.spacegray.sidebar.show_icons": true,

image

Sidebar Item Label VCS Coloring

  "theme.spacegray.sidebar.vcs_color_labels": true,

To also color expanded folders:

  "theme.spacegray.sidebar.vcs_color_expanded": true,

Originally implemented in Toxin by @p3lim.


Thanks

The Spacegray Eighties variation is contributed by Yoshua Wuyts.