Salesforce colORG

Stay organized, easily identify your default org and prevent unwanted deployments with Salesforce ColORG. The extension will automatically change the color of your VScode workspace based on the Salesforce org you're currently connected to. Define the set of rules and the colors to apply and start boosting your productivity!

How it works

Follow the steps below to configure your rules. This will identify your org aliases to apply specific colors for them. Once configured, the extension will run in the background each time you change your default org alias (using the SFDX CLI command, the SFDX VSCode extension, etc.) and will automatically update your workspace color settings based on the rules.

1. Define your own rules

Go to your Visual Studio Code settings and find the Rules setting under the Salesforce ColORG extension. The rules are a list of objects with two attributes:

Here there's an example with two rules configured. You can add as many as you want:

"sf-colorg.rules": [
	{
		"regex": "^\\w*_PROD$",
		"color": "#E15A60"
	},
	{
		"regex": "^\\w*_UAT$",
		"color": "#00AE6B"
	}
]

You can find here some pre-defined Regular Expressions to help you with the initial setup:

Some important things to keep in mind:

• You need to escape your Regular Expression to be able to include it in the JSON settings. You can use use this online tool for Javascript Escape / Unescape
• If your org alias matches multiple rules, only the first one will be applied
• If your org alias doesn't match any rule, the workspace will display the default color of your VSCode Theme
• Having a long list of rules might have some negative impacts on the performance, because every time your default org changes, all the rules might need to be evaluated

2. Specify where to apply the color

You can define whether the color will change in your VSCode workspace for the Activity Bar, the Satus Bar or both of them!

FAQ

After the release 1.1.0, the color is not changing anymore when I select a different org alias

See details

The configuration for a VSCode extension can be done at two levels: User and Workspace. Initially, the extension was configured to work only at User level. In the release 1.1.0 we added a feature to support multiple VSCode windows (workspaces) opened at the same time with different projects. VSCode will first get the configuration defined at Workspace-level, and if none is found, then it will get the one at User-level. Because of this, if there's a Workspace-level configuration defined (or empty list of rules for example), the extension will use those rules and you might not see any change of color. To fix this: 1. Go to you VSCode Settings and find the Salesforce ColORG extension

2. For the Rules attribute, if you see _Also modified in Workspace_, it means that you have a set of rules also defined at Workspace-level

3. Click on Workspace, and edit the Rules (Workspace-level) in the `settings.json` file

3. You can either modify the JSON to apply a set of rules that will be used only for this Workspace, or delete it (including the attribute name `sf-colorg.rules`) so the User-level rules will be applied for your workspaces