Salesforce DX Developer Guide

How Salesforce Developer Experience Changes the Way You Work
Enable Dev Hub Features in Your Org
Project Setup
Sample Repository on GitHub
Create a Salesforce DX Project
Salesforce DX Project Structure and Source Format
How to Exclude Source When Syncing or Converting
Create a Salesforce DX Project from Existing Source
Retrieve Source from an Existing Managed Package
Retrieve Unpackaged Source Defined in a package.xml File
Convert the Metadata Source to Source Format
Salesforce DX Usernames and Orgs
Override or Add Definition File Options at the Command Line
Link a Namespace to a Dev Hub Org
Salesforce DX Project Configuration
Multiple Package Directories
Replace Strings in Code Before Deploying
Authorization
Metadata Coverage
Scratch Orgs
Sandboxes
Track Changes Between Your Project and Org
Development
Build and Release Your App
First-Generation Managed Packages
Second-Generation Managed Packages
Partner Licensing Platform (Developer Preview)
Unlocked Packages
Continuous Integration
Troubleshoot Salesforce DX
Limitations for Salesforce DX
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Create a Salesforce DX Project from Existing Source

If you are already a Salesforce developer or ISV, you likely have existing source in a managed package in your packaging org or some application source in your sandbox or production org. Before you begin using Salesforce DX, retrieve the existing source and convert it to the source format.

If your current repo follows the directory structure that is created from a Metadata API retrieve, you can skip to converting the metadata format after you create a Salesforce DX project.

Tip

  1. Create a Salesforce DX project.
  2. Create a directory for the metadata retrieve. You can create this directory anywhere. 
    1mkdir mdapipkg
  3. Retrieve your metadata source.
    Format of Current Source How to Retrieve Your Source for Conversion
    You are a partner who has your source already defined as a managed package in your packaging org. Retrieve Source from an Existing Managed Package
    You have a package.xml file that defines your unpackaged source. Retrieve Unpackaged Source Defined in a package.xml file