chore: update project for developer edition and production org support (#33)

* chore: update project for developer edition and production org support

* ci: update ci workflows to single deploy

* ci: pin SF CLI to 2.142.6 to fix Node 22.23+ hang

* ci: reorder scratch org steps to build before deploy

* style: format new metadata files

Author: charlesw-salesforce

.github/workflows/ci-pr.yml

@@ -126,7 +126,7 @@ jobs:
       # Install Salesforce CLI
       - name: "Install Salesforce CLI"
         run: |
-          npm install @salesforce/cli --location=global
+          npm install @salesforce/cli@2.142.6 --location=global
           nodeInstallPath=$(npm config get prefix)
           echo "$nodeInstallPath/bin" >> $GITHUB_PATH
           cd "$nodeInstallPath/bin"
@@ -170,7 +170,7 @@ jobs:
       # Install Salesforce CLI
       - name: "Install Salesforce CLI"
         run: |
-          npm install @salesforce/cli --location=global
+          npm install @salesforce/cli@2.142.6 --location=global
           nodeInstallPath=$(npm config get prefix)
           echo "$nodeInstallPath/bin" >> $GITHUB_PATH
           sf --version
@@ -200,37 +200,33 @@ jobs:
         if: ${{ !env.IS_PRERELEASE }}
         run: sf org create scratch -f config/project-scratch-def.json -a scratch-org -d -y 1
 
-      # Deploy shared metadata to scratch org
+      # Install React app dependencies
+      - name: "Install React app dependencies"
+        run: npm ci --prefix force-app/main/react-recipes/uiBundles/reactRecipes
+
+      # Build React app
+      - name: "Build React app"
+        run: npm run build
+        working-directory: force-app/main/react-recipes/uiBundles/reactRecipes
+
+      # Deploy to scratch org
       - name: "Deploy source to scratch org"
-        run: sf project deploy start -d force-app/main/default/objects -d force-app/main/default/classes -d force-app/main/default/permissionsets -d force-app/main/default/cspTrustedSites
+        run: sf project deploy start
 
       # Assign permissionset
       - name: "Assign permissionset to default user"
         run: sf org assign permset -n recipes
 
-      # Import sample data
-      - name: "Import sample data"
-        run: sf data tree import -p ./data/data-plan.json
-
-      # Install React app dependencies
-      - name: "Install React app dependencies"
-        run: npm ci --prefix force-app/main/react-recipes/uiBundles/reactRecipes
-
       # Fetch GraphQL schema and run codegen
       - name: "GraphQL schema and codegen"
         run: |
           npm run graphql:schema
           npm run graphql:codegen
         working-directory: force-app/main/react-recipes/uiBundles/reactRecipes
 
-      # Build React app
-      - name: "Build React app"
-        run: npm run build
-        working-directory: force-app/main/react-recipes/uiBundles/reactRecipes
-
-      # Deploy UI bundle to scratch org
-      - name: "Deploy UI bundle"
-        run: sf project deploy start --source-dir force-app/main/react-recipes/uiBundles/reactRecipes
+      # Import sample data
+      - name: "Import sample data"
+        run: sf data tree import -p ./data/data-plan.json
 
       # Run Apex tests in scratch org
       - name: "Run Apex tests"

.github/workflows/ci.yml

@@ -109,7 +109,7 @@ jobs:
       # Install Salesforce CLI
       - name: "Install Salesforce CLI"
         run: |
-          npm install @salesforce/cli --location=global
+          npm install @salesforce/cli@2.142.6 --location=global
           nodeInstallPath=$(npm config get prefix)
           echo "$nodeInstallPath/bin" >> $GITHUB_PATH
           cd "$nodeInstallPath/bin"
@@ -152,7 +152,7 @@ jobs:
       # Install Salesforce CLI
       - name: "Install Salesforce CLI"
         run: |
-          npm install @salesforce/cli --location=global
+          npm install @salesforce/cli@2.142.6 --location=global
           nodeInstallPath=$(npm config get prefix)
           echo "$nodeInstallPath/bin" >> $GITHUB_PATH
           sf --version
@@ -176,37 +176,33 @@ jobs:
       - name: "Create scratch org"
         run: sf org create scratch -f config/project-scratch-def.json -a scratch-org -d -y 1
 
-      # Deploy shared metadata to scratch org
+      # Install React app dependencies
+      - name: "Install React app dependencies"
+        run: npm ci --prefix force-app/main/react-recipes/uiBundles/reactRecipes
+
+      # Build React app
+      - name: "Build React app"
+        run: npm run build
+        working-directory: force-app/main/react-recipes/uiBundles/reactRecipes
+
+      # Deploy to scratch org
       - name: "Deploy source to scratch org"
-        run: sf project deploy start -d force-app/main/default/objects -d force-app/main/default/classes -d force-app/main/default/permissionsets -d force-app/main/default/cspTrustedSites
+        run: sf project deploy start
 
       # Assign permissionset
       - name: "Assign permissionset to default user"
         run: sf org assign permset -n recipes
 
-      # Import sample data
-      - name: "Import sample data"
-        run: sf data tree import -p ./data/data-plan.json
-
-      # Install React app dependencies
-      - name: "Install React app dependencies"
-        run: npm ci --prefix force-app/main/react-recipes/uiBundles/reactRecipes
-
       # Fetch GraphQL schema and run codegen
       - name: "GraphQL schema and codegen"
         run: |
           npm run graphql:schema
           npm run graphql:codegen
         working-directory: force-app/main/react-recipes/uiBundles/reactRecipes
 
-      # Build React app
-      - name: "Build React app"
-        run: npm run build
-        working-directory: force-app/main/react-recipes/uiBundles/reactRecipes
-
-      # Deploy UI bundle to scratch org
-      - name: "Deploy UI bundle"
-        run: sf project deploy start --source-dir force-app/main/react-recipes/uiBundles/reactRecipes
+      # Import sample data
+      - name: "Import sample data"
+        run: sf data tree import -p ./data/data-plan.json
 
       # Run Apex tests in scratch org
       - name: "Run Apex tests"

AGENT.md

@@ -14,7 +14,7 @@ The full project plan lives in **PLAN.md**. This file covers what you need to kn
 
 ```
 multiframework-recipes/                     # Repository root (Salesforce DX project)
-  sfdx-project.json                         # Salesforce DX config (API v66.0)
+  sfdx-project.json                         # Salesforce DX config (API v67.0)
   package.json                              # Root -- SFDX scripts only, NOT the React app
   data/                                     # Sample data for sf data import tree (planned)
   force-app/main/default/                        # Shared metadata (objects, classes, etc.)
@@ -323,7 +323,7 @@ Global styles: `src/styles/global.css` (Tailwind + CSS variables), `src/styles/s
 
 - **`ui-bundle.json`**: Output dir `dist/`, SPA fallback routing, trailing slash `never`
 - **`reactRecipes.uibundle-meta.xml`**: Metadata definition (v1, isActive)
-- **`sfdx-project.json`**: Package dir `force-app`, API version 66.0
+- **`sfdx-project.json`**: Package dir `force-app`, API version 67.0
 - Only one UI bundle can be deployed per metadata push
 
 ---

README.md

@@ -9,9 +9,7 @@ A collection of easy-to-digest code examples for building apps on the Salesforce
 
 This sample application is designed to run on the Salesforce Platform. It covers what a frontend developer needs to know about Salesforce, and what a Salesforce developer needs to know about modern frameworks — taught at the intersection.
 
-> Multi-Framework currently supports **React**, with additional frameworks coming over time. The feature is in Beta and only available in Scratch Orgs and Sandboxes — not yet in Developer Edition orgs or Trailhead Playgrounds.
->
-> There is a known limitation where orgs that do not use English (`en_US`) as the default language may experience issues. The scratch org definition in this project explicitly sets `"language": "en_US"` to work around this. If you are using a sandbox or other org type, ensure the default language is set to English.
+> Multi-Framework currently supports **React**, with additional frameworks coming over time.
 
 **Learn more:** Read the [Salesforce Multi-Framework developer guide](https://developer.salesforce.com/docs/platform/einstein-for-devs/guide/reactdev-overview.html) for a comprehensive overview.
 
@@ -28,9 +26,7 @@ graph LR
 ## Table of Contents
 
 - [Setting up a Scratch Org](#setting-up-a-scratch-org)
-- [Setting up a Sandbox](#setting-up-a-sandbox)
-- [Developer Edition](#developer-edition)
-- [Install & Deploy React Recipes](#install--deploy-react-recipes)
+- [Setting up a Developer Edition Org](#setting-up-a-developer-edition-org)
 - [Local Development](#local-development)
 - [Testing](#testing)
 - [Optional installation instructions](#optional-installation-instructions)
@@ -66,10 +62,21 @@ graph LR
    sf org create scratch -d -f config/project-scratch-def.json -a recipes
    ```
 
-1. Deploy shared metadata:
+1. Install dependencies, fetch the GraphQL schema, and build React Recipes:
 
    ```bash
-   sf project deploy start -d force-app/main/default/objects -d force-app/main/default/classes -d force-app/main/default/permissionsets -d force-app/main/default/cspTrustedSites
+   cd force-app/main/react-recipes/uiBundles/reactRecipes
+   npm install
+   npm run graphql:schema
+   npm run graphql:codegen
+   npm run build
+   cd ../../../../..
+   ```
+
+1. Deploy metadata and the UI bundle:
+
+   ```bash
+   sf project deploy start
    ```
 
 1. Assign the **recipes** permission set to the default user:
@@ -84,7 +91,13 @@ graph LR
    sf data tree import -p ./data/data-plan.json
    ```
 
-## Setting up a Sandbox
+1. Open the org and select the **React Recipes** app in App Launcher:
+
+   ```bash
+   sf org open
+   ```
+
+## Setting up a Developer Edition 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:
    - Install Salesforce CLI
@@ -95,10 +108,10 @@ graph LR
 
 1. Make sure you have **Salesforce CLI v2.130.7+** installed. This version includes the UI Bundle plugin. Check your version with `sf --version` and update with `sf update` if needed.
 
-1. Authorize your sandbox org and provide it with an alias (**mysandbox** in the command below):
+1. Authorize your Developer Edition org and provide it with an alias (**mydevorg** in the command below):
 
    ```bash
-   sf org login web -a mysandbox
+   sf org login web -a mydevorg
    ```
 
 1. Clone this repository:
@@ -108,53 +121,36 @@ graph LR
    cd multiframework-recipes
    ```
 
-1. Deploy shared metadata:
-
-   ```bash
-   sf project deploy start -d force-app/main/default/objects -d force-app/main/default/classes -d force-app/main/default/permissionsets -d force-app/main/default/cspTrustedSites
-   ```
-
-1. Assign the **recipes** permission set to the default user:
-
-   ```bash
-   sf org assign permset -n recipes
-   ```
-
-1. Import sample data:
-
-   ```bash
-   sf data tree import -p ./data/data-plan.json
-   ```
-
-## Developer Edition
-
-Developer Edition support is coming soon.
-
-## Install & Deploy React Recipes
-
-1. Install dependencies, fetch the GraphQL schema, and run codegen:
+1. Install dependencies, fetch the GraphQL schema, and build React Recipes:
 
    ```bash
    cd force-app/main/react-recipes/uiBundles/reactRecipes
    npm install
    npm run graphql:schema
    npm run graphql:codegen
+   npm run build
+   cd ../../../../..
    ```
 
-1. Build the app:
+1. Deploy metadata and the UI bundle:
 
    ```bash
-   npm run build
+   sf project deploy start
    ```
 
-1. Deploy the UI bundle to your org:
+1. Assign the **recipes** permission set to the default user:
 
    ```bash
-   cd ../../../../..
-   sf project deploy start --source-dir force-app/main/react-recipes/uiBundles/reactRecipes
+   sf org assign permset -n recipes
+   ```
+
+1. Import sample data:
+
+   ```bash
+   sf data tree import -p ./data/data-plan.json
    ```
 
-1. Open the scratch org and select the **React Recipes** app in App Launcher:
+1. Open the org and select the **React Recipes** app in App Launcher:
 
    ```bash
    sf org open

force-app/main/default/applications/reactRecipes.app-meta.xml

@@ -1,4 +1,4 @@
-<?xml version="1.0" encoding="UTF-8"?>
+<?xml version="1.0" encoding="UTF-8" ?>
 <CustomApplication xmlns="http://soap.sforce.com/2006/04/metadata">
    <brand>
        <headerColor>#0070D2</headerColor>