Loading
Salesforce Enforces New Security Requirements in Summer 2026Read More
Install and Configure DevOps Center (Managed Package)
Add Salesforce DX Project File to Bitbucket Repository

Add Salesforce DX Project File to Bitbucket Repository

To support DevOps Center features, the Bitbucket repository must follow the Salesforce DX project structure and contain a Salesforce DX project file.

For Bitbucket beta, we aren’t providing a Salesforce DX project repository template. If the repository you plan to use with DevOps Center doesn’t contain an sfdx-project.json file, you must add one.

  1. In Bitbucket, navigate to your repository.
  2. From the context menu, select Add File.
  3. Enter sfdx-project.json for the filename.
  4. Copy these contents, then click Commit.
    {
      "packageDirectories": [
        {
          "path": "force-app",
          "default": true,
          "versionName": "Winter '25",
          "versionNumber": "1.0.0.NEXT"
        }
      ],
      "namespace": "",
      "sourceApiVersion": "61.0"
    }

    You can indicate a different directory for the path, which indicates where your source is located. If that directory doesn’t currently exist, you must create it.

    Accept for update the commit message, then click Commit.

  5. (Optional) If the path indicated in the sfdx-project.json file doesn’t exist, create it.
    1. Go back to the repository view.
    2. From the context menu, select Add File.
    3. For the filename, indicate force-app/text.txt.
      To create the directory, you must also create a file. Add a comment to the text file so you can commit it.
    4. Click Commit, accept or update the commit comment, then click Commit again.
 
Loading
Salesforce Help | Article