0.1.0 • Published 5 years ago

dainty-vs v0.1.0

Weekly downloads
3
License
-
Repository
-
Last release
5 years ago

Dainty for Visual Studio

Dainty is a configurable, refined, and balanced color theme using carefully selected colors within the CIELAB color space. It is designed to maximize readability and reduce eye strain.

For more information and web-based configuration, see https://dainty-vs.now.sh.

Screenshot

image

Features

  • Precise and pleasant colors are generated and selected within the CIELAB color space
  • Punctuation marks are slightly dimmed
  • Left side of the editor is less busy than in the default themes
  • Lightness of environment background and foreground can be adjusted
  • Lightness of editor background and foreground can be adjusted
  • Contrast for comments can be added
  • Contrast for scrollbars can be added
  • Transparent environment borders can be set
  • Transparent scrollbar containers can be set
  • Transparent tool window grip handles can be set
  • Settings for Indent Guides extension can be included
  • Colors can be lightened, darkened, or desaturated
  • Colors can be overridden
  • Usages of colors can be overridden
  • Supports configuration presets

Setup

git clone https://github.com/alexanderte/dainty-shared.git
cd dainty-shared
npm install
cd ..
git clone https://github.com/alexanderte/dainty-vs.git
cd dainty-vs
npm install

Build

npm run build

The build script generates dist/dainty.vstheme and dist/dainty.vssettings.

Configuration

Dainty can be configured by editing configuration.json. See Configuration among applications for more details.

Overriding usages of colors

Usages of environment colors and editor tokens can be overridden by adding the following object to the root of configuration.json:

"replacements": {
  "overrides": {
    "searchReplace": {
      "#b5cea8": ["PURPLE_20", "PURPLE_20"]
    },
    "categories": {
      "ColorizedSignatureHelp colors": {
        "HTML Attribute Value": [[null, "BLUE_0"], [null, "BLUE_32"]]
      }
    }
  }
}

Each replacement is a tuple, where the first value represents the dark variation of the theme. The second value represents the light variation. For categories there is an inner tuple representing the background and text color, respectively.

Server

Run npm run start to start Express server. These are the available routes:

MethodRouteDescription
GET/Landing page
GET/colors.htmlColor scales page
GET/coverage.htmlCoverage page
GET/syntax.htmlSyntax page
GET/dainty-latest.zipGenerates the latest version of Dainty with default configuration
POST/dainty-latest-configured.zipGenerates the latest version of Dainty with custom configuration1
  1. Custom configuration is sent as JSON using the request body, and the format is defined by configuration-schema.json.

License

Dainty for Visual Studio is licensed under the MIT License.