A powerful GitHub Action that simplifies and automates the creation of Second-Generation Packages (2GP) for Salesforce. Say goodbye to manual package creation and hello to streamlined CI/CD workflows!

Creating and managing Salesforce 2GP packages can be time-consuming and error-prone. This action transforms your packaging experience:

• 🚀 Accelerate Delivery - Automate package creation in your CI/CD pipeline
• 🔄 Ensure Consistency - Standardize package versioning across your organization
• ⏱️ Save Time - Eliminate manual steps in your release process
• 📊 Gain Visibility - Track package creation status with detailed reporting
• 🔌 Plug and Play - Integrate seamlessly with your existing GitHub workflows
• 🛡️ Reduce Errors - Eliminate common mistakes in the packaging process

• 🔐 Authenticate with a Salesforce Dev Hub org
• 📦 Create a new package version with customizable options
• 🔄 Poll for package creation status
• ✏️ Update package aliases in the sfdx-project.json file
• ⚙️ Configurable timeout and polling intervals

Add this workflow to your project in .github/workflows/create-package.yml:

name: Create Salesforce Package Version

on:
  push:
    branches:
      - main
  workflow_dispatch:

env:
  PACKAGE_NAME: MyPackage
  TARGET_DEV_HUB: DevHub

jobs:
  create-package-version:
    name: Create package version
    runs-on: ubuntu-latest

    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Setup Node
        uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'

      - name: Create package version
        uses: mathias-moreira/salesforce-ci-packager@v2
        id: create-package-version
        with:
          auth-url: ${{ secrets.AUTH_URL }}
          package-name: ${{ env.PACKAGE_NAME }}
          package-type: Unlocked
          target-dev-hub: ${{ env.TARGET_DEV_HUB }}
          installation-key-bypass: true
          code-coverage: true

      - name: Show package details
        run: |
          echo "Package Version ID: ${{ steps.create-package-version.outputs.package-version-id }}"
          echo "Package Version Number: ${{ steps.create-package-version.outputs.package-version-number }}"

This action uses the following Salesforce CLI commands:

• sf package create: Creates a new package
• sf package list: Lists all packages in the Dev Hub org
• sf package version create: Creates a new package version
• sf package version create report: Checks the status of a package version creation request

For more information about these commands, see the Salesforce CLI Command Reference.

We welcome contributions! Please see CONTRIBUTING.md for detailed guidelines on how to contribute to this project, including local development setup and testing.

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

• Salesforce DX Developer Guide
• Second-Generation Packages
• GitHub Actions Documentation

💡 Tip: Store your auth-url as a GitHub secret to keep your credentials secure!

⭐ If you find this action helpful, consider giving it a star on GitHub!