Salesforce DX Developer Guide

How Salesforce Developer Experience Changes the Way You Work
Project Setup
Salesforce CLI Configuration and Tips
Sample Repository on GitHub
Create a Salesforce DX Project
Create a Salesforce DX Project from Existing Source
Retrieve Source from an Existing Managed Package
Retrieve Unpackaged Source Defined in a package.xml File
Retrieve Unpackaged Source by Creating a Temporary Unmanaged Package
Convert the Metadata API Source
Link a Namespace to a Dev Hub Org
Salesforce DX Project Configuration
Authorization
Scratch Orgs
Development
Build and Release Your App
Develop Packages (Beta)
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 Salesforce DX project format.

If your current repo follows the directory structure that is created from a Metadata API retrieve, you can skip to converting the Metadata API source 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
    You don’t have your source defined in a package. Retrieve Unpackaged Source by Creating a Temporary Unmanaged Package