---
schema_version: "1"
id: 6fa7b2c43e5314a73d13b84c0eb7bd299f7fef69958854920faaafd90c2b6333
title: Add Salesforce DX Project File to Bitbucket Repository
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/devops_center_add_sfdx_project.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.devops_center_add_sfdx_project.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: bd5856080a12bad5d1372a2ee4cb63119998bad4aaf9a5265d6ee9a01ea816e7
description: To support DevOps Center features, the Bitbucket repository must follow the Salesforce DX project structure and contain a Salesforce DX project file.
products:
  - Salesforce Platform
release: "264"
---
# 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](https://developer.salesforce.com/docs/atlas.en-us.250.0.sfdx_dev.meta/sfdx_dev/sfdx_dev_workspace_setup.htm) 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.

Next: [add team members as collaborators](https://help.salesforce.com/s/articleView?id=platform.devops_center_add_team_members_bitbucket.htm&release=264.0.0&type=5 "In Bitbucket, add team members as repository collaborators. A collaborator is someone who has been granted write access to the project repository. Add everyone who creates customizations or code for your project to the project repository as a collaborator. That way, they have access to the repository through DevOps Center."). You can then go to DevOps Center to [connect the repository](https://help.salesforce.com/s/articleView?id=platform.devops_center_bitbucket_connect_repo.htm&release=264.0.0&type=5 "Each DevOps Center project has a corresponding project repository. By connecting the Bitbucket repo to DevOps Center, DevOps Center can interact with the repo to perform operations such as creating feature branches, creating change requests, and committing and merging changes to each pipeline branch (stage).") and then [create a DevOps Center Bitbucket project](https://help.salesforce.com/s/articleView?id=platform.devops_center_bitbucket_create_project.htm&release=264.0.0&type=5 "After you connect the Bitbucket repository in DevOps Center, create the DevOps Center project associated with this source code repository to help you and your team manage changes for a particular application or customization.").