Definition
In Salesforce DX, a local project directory containing the sfdx-project.json file, source code, and metadata that developers use to build and deploy customizations to Salesforce orgs using the Salesforce CLI.
Real-World Example
an architect at Skyline Consulting uses Project to extend their Salesforce implementation to meet growing business demands. Project provides the additional capability they need without requiring a separate third-party system, keeping everything within the trusted Salesforce ecosystem and reducing integration complexity.
Why Project Matters
In Salesforce DX, a Project is a local project directory containing the sfdx-project.json file, source code, and metadata that developers use to build and deploy customizations to Salesforce orgs using the Salesforce CLI. The project structure follows DX conventions, with metadata organized into directories that can be tracked in Git for version control and collaboration.
DX projects are foundational to source-driven Salesforce development. Developers clone the project from Git, use the Salesforce CLI to push source to scratch orgs or sandboxes, work on changes, pull updates back to the project, and commit to Git. This workflow makes Salesforce development feel like modern web development with proper version control and collaboration. Mature Salesforce teams organize their work entirely around DX projects.
How Organizations Use Project
- •Quantum Labs — All developers work in DX projects cloned from Git, using scratch orgs as their development environment.
- •TerraForm Tech — Maintains entire metadata in Git as DX projects, treating Salesforce code like any other software project.
- •CodeBridge — Builds CI/CD pipelines around DX projects for automated deployment.