Modus themes for Visual Studio Code

This project brings Protesilaos Stavrou's Modus themes from GNU Emacs to Visual Studio Code.

Overview

Modus themes are designed for accessible readability. They conform with the highest standard for color contrast between combinations of background and foreground values. This corresponds to the WCAG AAA standard, which specifies a minimum contrast ratio of 7:1. This implementation for Visual Studio Code aims to adapt the original themes on a best effort basis while accounting for the different semantic token models and interface elements of VS Code.

Theme collection

The extension provides eight color themes, divided into four subgroups:

• Main themes: Modus Operandi (light) and Modus Vivendi (dark) are the project's primary themes. They are designed to cover a broad range of needs and serve as reference implementations for highly legible default themes.

• Tinted themes: Modus Operandi Tinted and Modus Vivendi Tinted are variants that slightly tone down the intensity of the background and provide more color variety. The light variant uses shades of light ochre (earthly colors), while the dark variant gives a night sky impression.

• Deuteranopia themes: Modus Operandi Deuteranopia and Modus Vivendi Deuteranopia are optimized for users with red-green color deficiency. They avoid using red and green hues for color-coding purposes, instead implementing colors that are discernible by users with deuteranopia or deuteranomaly (mostly yellow and blue hues).

• Tritanopia themes: Modus Operandi Tritanopia and Modus Vivendi Tritanopia are designed for users with blue-yellow color vision deficiency. They adapt the color palette to remain distinguishable for those with tritanopia or tritanomaly.

Installation

From VS Code Marketplace

1. Open VS Code
2. Access the Extensions view (Ctrl+Shift+X or Cmd+Shift+X on macOS)
3. Search for "Modus"
4. Select and install the extension

Alternatively, use the Quick Open command:

Ctrl+P -> ext install wroyca.modus

Manual installation

Download the VSIX file from the releases page and install it via:

code --install-extension modus-x.y.z.vsix

Where x.y.z represents the version number.

Usage

Activating a theme

1. Open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P on macOS)
2. Type "Preferences: Color Theme" and select it
3. Select one of the Modus themes from the list

Alternatively, use the keyboard shortcut:

1. Press Ctrl+K then Ctrl+T (or Cmd+K then Cmd+T on macOS)
2. Select one of the Modus themes

References

• Official Modus themes documentation: https://protesilaos.com/emacs/modus-themes
• VS Code themes documentation: https://code.visualstudio.com/api/extension-guides/color-theme

Acknowledgments

This project wouldn't exist without Protesilaos Stavrou, who created the original Modus themes for Emacs.

License

This extension is distributed under the MIT license.