jacob-j / vscode-folder-path-color

All subfolders within a specified path will be assigned a color for easy differentiation.
20 stars 6 forks source link

Folder Path Color

This extension allows you to color-code folders and files in Visual Studio Code by specifying paths and colors in your workspace settings. The colors are visible in the Explorer view and in the tabs, unless overridden by the app.

Screenshot

Works in search and tabs as well.

CleanShot 2023-06-05 at 15 43 35@2x

Features

This extension provides the ability to customize the appearance of folders in your workspace explorer. You can assign colors and symbols to folders based on their paths, and the assigned color and symbol will be displayed next to the folder name. You can also specify a tooltip for each folder, which will be displayed when you hover over the folder's symbol.

There are 6 slots for custom colors at this time, which you can update with the workbench.colorCustomizations user setting.

[!NOTE] It's important to note that when a file is under source control and there are changes to be committed, Git will overwrite the file's color with its own color scheme. However, the symbol assigned by this extension will remain visible next to the file name. The custom color will still be shown for folders with Git changes.

In the source control tab, custom colors on files won't be visible due to VS Code's design, but the symbol will still be displayed next to the file name, providing a visual cue even in this scenario.

Requirements

This extension does not have any additional requirements or dependencies.

Extension Settings

Property Type Description
path string The path of the folder, relative to the workspace.
color string The color to assign to the folder. This should be one of the predefined color names.
symbol string A short symbol to display next to the folder. This should be a string of maximum 2 characters. You can also use an emoji for more visual display.
tooltip string A tooltip to display when you hover over the folder's symbol.

Predefined color names: blue, magenta, red, cyan, green, yellow.

Example configuration:

"folder-path-color.folders": [
    { "path": "frontend", "symbol": "SR", "tooltip": "Source files" },
    { "path": "packages/common", "symbol": "T", "tooltip": "Common" }
]
Property Type Default based on theme (Dark/Light)
custom1 string #ABCDEF / #123456
custom2 string #FEDCBA / #654321
custom3 string #AADDFF / #336699
custom4 string #FF99AA / #882244
custom5 string #AAFF99 / #448822
custom6 string #AA99FF / #442288

Example configuration:

"workbench.colorCustomizations": {
    "folderPathColor.custom1": "#FF4488",
    "folderPathColor.custom2": "#88ff44",
    "folderPathColor.custom3": "#4488FF",
},

Following extension guidelines

This extension follows the Extension Guidelines provided by Visual Studio Code.

Enjoy!