SharinPix Salesforce CLI Plugin

GitHub - SharinPix/sharinpix-sf-plugin: SharinPix salesforce pluginGitHub

The SharinPix Salesforce CLI plugin allows you to synchronize SharinPix forms, permissions, and settings between a Salesforce org and local configuration files.

This makes it easier to version, review, and deploy the SharinPix configuration across environments.

In this article, we will demonstrate how to:

• Install the SharinPix Salesforce CLI plugin

• Authenticate to a Salesforce org

• Pull all SharinPix configuration locally

• Push all local changes back to Salesforce

Prerequisites

Before you begin, ensure that:

• Salesforce CLI (sf) is installed

  If it is not installed, follow the official installation guide and ensure the sf command is available in your terminal before continuing.

• You have access to a Salesforce org (Sandbox, UAT, or Production)

• Your Salesforce user has access to SharinPix features (Forms and Permissions)

Install the Plugin

Install the plugin using the Salesforce CLI:

sf plugins install @sharinpix/sharinpix-sf-plugin

Verify the installation:

sf plugins

Authenticate to Salesforce

Log in to your Salesforce org using the web-based authentication flow:

sf org login web

It is recommended to define an alias for the org:

sf org alias set [email protected]

You can list authenticated orgs with:

sf org list

Configuration

Target Org

All plugin commands require a target Salesforce org.

This can be provided using the login username.

-o [email protected]

Local Configuration Files

The plugin works with local configuration files:

• Pull commands generate or update local files

• Push commands read from those files and apply changes to Salesforce

It is recommended to commit these files to version control so configuration changes can be reviewed and deployed consistently.

Push Cleanup Behavior

Warning

Some push commands support removing Salesforce records that no longer exist locally.

This should only be used when local files are considered the source of truth, and with caution—especially in shared or production environments.

Synchronizing SharinPix Configuration

Pull all the configuration from Salesforce

sf sharinpix pull -o [email protected]

This retrieves all supported SharinPix configurations (forms and permissions) from the target org and stores them locally.

Push all local configuration to Salesforce

sf sharinpix push -o [email protected]

This applies the local configuration back to the Salesforce org.

Verification

After running a pull or push command, verify that:

• The correct Salesforce org was targeted

• Local configuration files were created or updated

• No errors were reported by the CLI

Additional Information

For a complete list of supported commands, options, and flags, refer to the official GitHub README:

sharinpix-sf-plugin/README.md at main · SharinPix/sharinpix-sf-pluginGitHub