🚀 Simple SF CLI


> We value your feedback! Please share your thoughts on how we can enhance your ci-cd with SimpleSfCli User Feedback form

Supercharge Your Salesforce Deployments in Just Seconds!

Simple SF CLI is a lightweight, 19 kb Node.js-powered command-line tool (unpacked size: ~81kb) crafted to streamline your Salesforce DX (SF) workflows. Convert, package, and deploy your SFDX projects to Salesforce in record-breaking 5-7 seconds—all without Salesforce CLI or plugins.

🎯 Why Choose Simple SF CLI?

- No Salesforce CLI Required: Say goodbye to additional dependencies and complex configurations.
- Zero Installation Overhead: Use it directly with npx no local installations needed.
- Blazing Fast Setup: Set up in 3-5 seconds, making it perfect for CI/CD pipelines.
- Built from Scratch: With just 4 dependencies, fully customized for reliability and speed.

Prerequisites

Before using the simpleSfCli plugin, ensure you meet the following requirements:

- [ ] Create a Private Key and Self-Signed Digital Certificate
Generate a private key and a self-signed digital certificate. This is essential for establishing a secure JWT-based connection with Salesforce.

- [ ] Create a Custom Connected App
Set up a connected app in your Salesforce instance and upload the digital certificate to it. This enables API-based authentication for your application.

If you are not familiar with setting up the JWT flow for Salesforce authentication, please refer to Salesforce's guide:
Create a Private Key and Self-Signed Digital Certificate.

> You do not need to install the Salesforce CLI (sf cli) to complete these steps or use the simpleSfCli plugin. This plugin is designed to simplify interactions with Salesforce without relying on the Salesforce CLI.

🛠 Features That Stand Out

- ⚡ Lightning-Fast Deployments: Push your SFDX projects to Sandbox or Production faster than it takes to install Salesforce CLI.
- 📄 Automated package.xml Generation: Leverage Metadata API for seamless deployments.
- ✂️ Selective Deployments: Exclude specific metadata components with ease.
- 🤝 CI/CD Ready: Integrates smoothly with tools like GitHub Actions, Bitbucket, and more.
- 📑 Comprehensive Logs: Detailed error tracking for hassle-free debugging.

⚡ Get Started in Seconds!

Run the CLI with npx—no need for installation!
bash
Copy code
npx simple-sf-cli [options]
Watch as your deployment completes in record time.

📦 Package Details

| Detail | Value |
|-----------------------|---------|
| Package Size | 19.1 kB |
| Unpacked Size | 78.3 kB |

📦 Supported Components

Link Here

Elevate your Salesforce deployment game with Simple SF CLI — the ultimate tool for developers on the move.

Try it now:

$3

Install globally via NPM for repeated use:

``bash
npm install -g simple-sf-cli
`

`bash
simpleSfCli \
--username myUser@example.com \
--clientId myClientId \
--privateKey ./server.key \
--env PRODUCTION \
--exclude Profile,NamedCredential
`

$3


Skip the installation hassle and use npx for instant execution:

`bash
npx simple-sf-cli \
--username myUser@example.com \
--clientId myClientId \
--privateKey ./server.key \
--env PRODUCTION \
--exclude Profile,NamedCredential
`

$3


`bash
simpleSfCli --help

Options:
-V, --version output the version number
-u, --username* Salesforce username
-c, --clientId* Salesforce client ID
-k, --privateKey* Salesforce private key
-e, --env* Production or Sandbox [Default]
-e, --exclude List of metadata types to exclude, e.g.,NamedCredential, Profile
-s, --source Path to the SFDX source directory, unless "force-app/main/default"
-h, --help display help for command
-t, --testLevel NoTestRun,RunSpecifiedTests,RunLocalTests,RunLocalTests
-v, --validateOnly Validates the metadata without deployment

Note: * is a Required option

`

$3


You can exclude specific metadata types from the deployment using the --exclude option:
`bash
simple-sf-cli --source --output --exclude NamedCredential,Profile
`

$3

$3

| Option | Description |
|------------------------------|-------------------------------------------------------------------------------------------------------|
| -V, --version | Outputs the current version of simpleSfCli. |
| -u, --username* | Required. Specifies the Salesforce username. |
| -c, --clientId* | Required. Specifies the Salesforce Client ID. |
| -k, --privateKey* | Required. Specifies the path to the Salesforce private key file. |
| -e, --env* | Required. Sets the target Salesforce environment. Can be Production or Sandbox (default). |
| -e, --exclude | Excludes specific metadata types from deployment. List metadata types separated by commas. |
| -s, --source | Specifies the path to the SFDX source directory. Defaults to force-app/main/default if not provided. |
| -h, --help` | Displays detailed help for the command. |

Note: * is a Required option
---

License

This project is licensed under the MIT License - see the LICENSE file for details.