Apex Recipes is a library of concise, meaningful examples of code for common use cases utilizing best practices. They reflect enterprise patterns that can be utilized for real world solutions and should relevant to developers of all skill levels. The code is intended to reflect clarity while trying to maintain brevity. See the Table of Contents for installation options. We recommend using the Salesforce CLI and a scratch org for your initial deployment.
Learn more about this app by completing the Quick Start: Explore the Apex Recipes Sample App Trailhead project.
-
Installing Apex Recipes Using a Scratch Org: This is the recommended installation option. Use this option if you are a developer who wants to experience the app and the code.
-
Installing Apex Recipes Using an Unlocked Package: This option allows anybody to experience the sample app without installing a local development environment.
-
Installing Apex Recipes using a Developer Edition Org or a Trailhead Playground via the Salesforce CLI: Useful when tackling Trailhead Badges or if you want the app deployed to a more permanent environment than a Scratch org.
-
Set up your environment. Follow the steps in the Quick Start: Lightning Web Components Trailhead project. The steps include:
- Enable Dev Hub in your Trailhead Playground
- Install Salesforce CLI
- Install Visual Studio Code
- Install the Visual Studio Code Salesforce extensions
-
If you haven't already done so, authorize with your hub org and provide it with an alias (myhuborg in the command below):
sf org login web -d -a myhuborg
-
Clone the apex-recipes repository:
git clone https://github.com/trailheadapps/apex-recipes cd apex-recipes
-
Create a scratch org and provide it with an alias (apex-recipes in the command below):
sf org create scratch -d -f config/project-scratch-def.json -a apex-recipes
-
Push the app to your scratch org:
sf project deploy start
-
Assign the Apex_Recipes permission set to the default user:
sf org assign permset -n Apex_Recipes
-
Assign the Walkthroughs permission set to the default user:
sf org assign permset -n Walkthroughs
-
Import Sample Data
sf data tree import -p ./data/data-plan.json sf data tree import -p ./data/data-plan2.json
-
Execute the Anonymous Apex setup script
sf apex run --file data/setup.apex
-
Open the scratch org:
sf org open
-
In App Launcher, select the Apex Recipes app.
Follow this set of instructions if you want to deploy the app to a more permanent environment than a Scratch org or if you don't want to install the local developement tools. You can use a non source-tracked orgs such as a free Developer Edition Org or a Trailhead Playground.
Make sure to start from a brand-new environment to avoid conflicts with previous work you may have done.
-
Log in to your org
-
Go to Setup, under Platform Cache, and click the "Request Trial Capacity" button. Request a Platform Cache Trial
-
Click this link to install the Apex Recipes unlocked package in your org.
-
Select Install for All Users
-
Once installed:
-
(Optional) Add additional data examples. In the data folder are sample CSV files which can be used by dataloader.io or the Import Data Wizard.
-
(Optional) Load the sample Junction objects data:
- Click the Setup Gear Icon
- Click Developer Console
- Click Debug
- Click Open Execute Anonymous Window
- Enter:
DataFactoryForPackageInstalls.generateData();
- Click Execute
-
Add the Apex Recipes permission set to your user:
- Go to Setup > Users > Permission Sets.
- Click Apex_Recipes.
- Click Manage Assignments.
- Check your user and click Add Assignments.
-
In App Launcher, select the Apex Recipes app.
- If the app does not load, please double check that the Apex Recipes permission set active on your user.
Follow this set of instructions if you want to deploy the app to a more permanent environment than a Scratch org. This includes non source-tracked orgs such as a free Developer Edition Org or a Trailhead Playground.
Make sure to start from a brand-new environment to avoid conflicts with previous work you may have done.
-
Clone this repository:
git clone https://github.com/trailheadapps/apex-recipes cd apex-recipes
-
Authorize with your Trailhead Playground or Developer Edition org and provide it with an alias (mydevorg in the command below):
sf org login web -s -a mydevorg
-
If you are setting up a Developer Edition: go to Setup, under Platform Cache, and click the "Request Trial Capacity" button. Request a Platform Cache Trial
-
Run this command in a terminal to deploy the app.
sf project deploy start -d force-app
-
Assign the
Apex_Recipes
permission set to the default user.sf org assign permset -n Apex_Recipes
-
Import Sample Data
sf data tree import -p ./data/data-plan.json sf data tree import -p ./data/data-plan2.json
-
Execute the Anonymous Apex setup script
sf apex run --file data/setup.apex
-
If your org isn't already open, open it now:
sf org open -o mydevorg
-
In App Launcher, select the Apex Recipes app.
- If the app does not load, please double check that the Apex Recipes permission set active on your user.
This repository contains several files that are relevant if you want to integrate modern web development tooling to your Salesforce development processes, or to your continuous integration/continuous deployment processes.
Prettier is a code formatter used to ensure consistent formatting across your code base. To use Prettier with Visual Studio Code, install this extension from the Visual Studio Code Marketplace. The .prettierignore and .prettierrc files are provided as part of this repository to control the behavior of the Prettier formatter.
Warning The current Apex Prettier plugin version requires that you install Java 11 or above.
ESLint is a popular JavaScript linting tool used to identify stylistic errors and erroneous constructs. To use ESLint with Visual Studio Code, install this extension from the Visual Studio Code Marketplace. The .eslintignore file is provided as part of this repository to exclude specific files from the linting process in the context of Lighning Web Components development.
ApexDocs is a NPM package for generating Markdown (.md) files from the Classes in this repository. The package.json file in
this repo includes an npm script for generating these Apex docs. Execute npm run apexdocs
to generate fresh docs. These docs are shipped as part of a Static Resource and are available in your org via the Apex Recipes app. Navigate to any class and click it's coresponding Docs tab.
This repository also comes with a package.json file that makes it easy to set up a pre-commit hook that enforces code formatting and linting by running Prettier and ESLint every time you git commit
changes.
To set up the formatting and linting pre-commit hook:
- Install Node.js if you haven't already done so
- Run
npm install
in your project's root folder to install the ESLint and Prettier modules (Note: Mac users should verify that Xcode command line tools are installed before running this command.)
Note: This projects also contains Jest tests for unit testing Lightning Web Components. If you experience errors regarding
deasync
when runningnpm install
please check out the troubleshooting information in the lwc-jest repository.
Prettier and ESLint will now run automatically every time you commit changes. The commit will fail if linting errors are detected. You can also run the formatting and linting from the command line using the following commands (check out package.json for the full list):
npm run lint
npm run prettier