asteria's Introduction

Asteria

This is Asteria, a balanced VS Code theme.

Note: This is a work in progress.

Installation

Open the Extensions sidebar panel in VS Code. View → Extensions
Search for Asteria
Click Install
When prompted, select Asteria as the color theme

In case of not being prompted to select a Color Theme upon installing, go to the menu bar and select: Code (File, on Windows) > Preferences > Color Theme > Asteria. Alternatively, you can use the shortcut ⌘/Ctrl + K > ⌘/Ctrl + T and select Asteria.

Recommended settings for a better experience

The typeface I used (as shown on the sample images) is Clincher Code — a beautiful coding typeface I love. You can get it for free (for personal use) at the Visual Studio Marketplace. I use some custom, personal typography-related settings, which you can achieve by adding the following to your settings.json file.

// Controls the font family
"editor.fontFamily": "'Clincher Code', monospace",

// Controls the font size in pixels
"editor.fontSize": 13,

// Controls letter spacing in pixels
"editor.letterSpacing": -0.4,

// Controls the font weight
"editor.fontWeight": 400,

// Controls the line height. Use 0 to compute the line height from the font size
"editor.lineHeight": 26,

// Enables/Disables font ligatures
"editor.fontLigatures": true

Customize/Override theme colors

You can customize/override the Asteria theme colors by adding the following theme-specific configuration to your settings file. For more advanced customization, refer to the corresponding VS Code Docs.

Example of basic customization

"editor.tokenColorCustomizations": {
  "[Asteria]": {
      "comments": "#229977"
  }
},

Example of advanced customization

"editor.tokenColorCustomizations": {
  "[Your_Custom_Asteria]": {
    "textMateRules": [
      {
        "scope": [
          "punctuation.definition.comment",
          "comment.block",
          "comment.line",
          "comment.block.documentation"
        ],
        "settings": {
          "foreground": "#ffff00"
        }
      }
    ]
  },
},

"workbench.colorCustomizations": {
  "[Your_Custom_Asteria]": {
    "sideBar.background": "#ffff00",
  }
},

Contributions, Issues & Suggestions

Any feedback, issue reporting or suggestion is welcome. Feel free to submit your concern via the Repo's GitHub Issues page, provide feedback or request a feature by submitting a PR.

Changelog

All notable changes to this project are documented in the changelog. Consider checking the changelog prior to filing any issues as they may have already been addressed.

asteria's People

Contributors

Watchers

asteria's Issues

algoritmau / asteria Goto Github PK