Salesforce DX Developer Guide

How Salesforce Developer Experience Changes the Way You Work
Use a Sample Repo to Get Started
Create an Application
Migrate or Import Existing Source
Project Setup
Authorization
Metadata Coverage
Scratch Orgs
Development
Build and Release Your App
First-Generation Managed Packages
Unlocked Packages (Generally Available) and Second-Generation Managed 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

Migrate or Import Existing Source

Use the Metadata API to retrieve the code, and then convert your source for use in a Salesforce DX project.

If your current repo follows the directory structure that is created from a Metadata API retrieve, you can skip the retrieve step and go directly to converting the source.

Tip

  1. Set up your project.
  2. Retrieve your metadata.
  3. Convert the metadata formatted source you just retrieved to source format.
  4. Authorize the Developer Hub org for the project.
  5. Configure your local project.
  6. Create a scratch org.
  7. Push the source from your project to the scratch org.
  8. Develop the app.
  9. Pull the source to sync your project and scratch org.
  10. Run tests.
  11. Add, commit, and push changes. Create a pull request.

Deploy your app using one of the following methods: