You are here:
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.
- In Bitbucket, navigate to your repository.
- From the context menu, select Add File.
- Enter sfdx-project.json for the filename.
- 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.
- (Optional) If the path indicated in the sfdx-project.json file doesn’t exist, create
it.
- Go back to the repository view.
- From the context menu, select Add File.
- 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.
- Click Commit, accept or update the commit comment, then click Commit again.
Next: add team members as collaborators. You can then go to DevOps Center to connect the repository and then create a DevOps Center Bitbucket project.

