Skip to content

Commit

Permalink
Added instructions for mdapi deploy (DE and TH Playground) (trailhead…
Browse files Browse the repository at this point in the history
…apps#268)

* Added instructions for mdapi deploy (DE and TH Playground)

* Update README.md
  • Loading branch information
pozil authored and jcaudron committed Mar 23, 2021
1 parent 4bcbd76 commit 11fb174
Showing 1 changed file with 54 additions and 7 deletions.
61 changes: 54 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,14 +8,17 @@ A collection of easy-to-digest code examples for Lightning Web Components. Each

> This sample application is designed to run on Salesforce Platform. If you want to experience Lightning Web Components on any platform, please visit https://lwc.dev, and try out our Lightning Web Components sample application [LWC Recipes OSS](https://github.com/trailheadapps/lwc-recipes-oss).
## Installation Instructions
## Table of contents

There are two ways to install Lightning Web Components Recipes:
- [Installing the app using a Scratch Org](#installing-the-app-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.

- [Using a Scratch Org](#installing-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.
- [Using an Unlocked Package](#installing-recipes-using-an-unlocked-package): This option allows anybody to experience the sample app without installing a local development environment.
- [Installing the app using an Unlocked Package](#installing-the-app-using-an-unlocked-package): This option allows anybody to experience the sample app without installing a local development environment.

## Installing Recipes using a Scratch Org
- [Installing the app using using a Developer Edition Org or a Trailhead Playground](#installing-the-app-using-a-developer-edition-org-or-a-trailhead-playground): Useful when tackling Trailhead Badges or if you want the app deployed to a more permanent environment than a Scratch org.

- [Optional installation instructions](#optional-installation-instructions)

## Installing the app using a Scratch Org

1. Set up your environment. Follow the steps in the [Quick Start: Lightning Web Components](https://trailhead.salesforce.com/content/learn/projects/quick-start-lightning-web-components/) Trailhead project. The steps include:

Expand All @@ -24,7 +27,7 @@ There are two ways to install Lightning Web Components Recipes:
- Install Visual Studio Code
- Install the Visual Studio Code Salesforce extensions, including the Lightning Web Components extension

1. If you haven't already done so, authenticate with your hub org and provide it with an alias (**myhuborg** in the command below):
1. If you haven't already done so, authorize your hub org and provide it with an alias (**myhuborg** in the command below):

```
sfdx force:auth:web:login -d -a myhuborg
Expand Down Expand Up @@ -71,7 +74,7 @@ There are two ways to install Lightning Web Components Recipes:
1. In App Launcher, click **View All** then select the **LWC** app.
## Installing Recipes using an Unlocked Package
## Installing the app using an Unlocked Package
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](https://developer.salesforce.com/signup) or a [Trailhead Playground](https://trailhead.salesforce.com/).
Expand All @@ -98,6 +101,50 @@ Make sure to start from a brand-new environment to avoid conflicts with previous
1. In App Launcher, click **View All** then select the **LWC** app.
## Installing the App using a Developer Edition Org or a Trailhead Playground
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](https://developer.salesforce.com/signup) or a [Trailhead Playground](https://trailhead.salesforce.com/).
Make sure to start from a brand-new environment to avoid conflicts with previous work you may have done.
1. Authorize your Trailhead Playground or Developer org and provide it with an alias (**mydevorg** in the command below):
```
sfdx force:auth:web:login -d -a mydevorg
```
1. Clone this repository:
```
git clone https://github.com/trailheadapps/lwc-recipes
cd lwc-recipes
```
1. If you are setting up a Developer Edition: go to **Setup**, under **My Domain**, [register a My Domain](https://help.salesforce.com/articleView?id=domain_name_setup.htm&type=5).
1. Run this command in a terminal to deploy the app.
```
sfdx force:source:deploy -p force-app
```
1. Assign the `recipes` permission set to the default user.
```
sfdx force:user:permset:assign -n recipes
```
1. Import some sample data.
```
sfdx force:data:tree:import -p ./data/data-plan.json
```
1. In **Setup**, under **Themes and Branding**, activate the **Recipes Lite** or **Recipes Blue** theme.
1. In App Launcher, select the **LWC** app.
## Optional Installation Instructions
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.
Expand Down

0 comments on commit 11fb174

Please sign in to comment.