SFDX Simple App
THIS PROJECT IS NO LONGER MAINTAINED. To learn about Salesforce Development with version control see the Trailhead project Develop an App with Salesforce CLI and Source Control.
The Salesforce Developer Experience (SFDX) starts with source code living in your version control system.
Set Up the Salesforce DX Project
Our first goal is to set up a developer project which we'll use to modify our application. It starts by cloning the repository. Use the command ...
git clone https://github.com/forcedotcom/sfdx-simple.git
… or ...
git clone firstname.lastname@example.org:forcedotcom/sfdx-simple.git
… to clone the repository. Then, open the directory.
Authorize to your Developer Hub (Dev Hub) org.
sfdx force:auth:web:login -d -a "Hub Org"
If you already have an authorized Dev Hub, set it as the default:
sfdx force:config:set defaultdevhubusername=<username|alias>
Create a scratch org.
sfdx force:org:create -s -f config/project-scratch-def.json
If you want to use an existing scratch org, set it as the default:
sfdx force:config:set defaultusername=<username|alias>
Push your source.
Run your tests.
sfdx force:apex:test:run sfdx force:apex:test:report -i <id>
Open the scratch org.
sfdx force:org:open --path one/one.app
For details on using sfdx-simple, please review the Salesforce DX Developer Guide.
Description of Files and Directories
- sfdx-project.json: Required by Salesforce DX. Configures your project. Use this file to specify the parameters that affect your Salesforce development project.
- config/project-scratch-def.json: Sample file that shows how to define the shape of a scratch org. You reference this file when you create your scratch org with the force:org:create command.
- force-app: Directory that contains the source for the sample Force.com app and tests.
- .project: Required by the Eclipse IDE. Describes the Eclipse project.
- .gitignore: Optional Git file. Specifies intentionally untracked files that you want Git (or in this case GitHub) to ignore.
Please log issues related to this repository here.