From e08db67b015001d1ed1617d91d921e1b8914ea99 Mon Sep 17 00:00:00 2001
From: Justin Horst <justin.horst@salesforce.com>
Date: Thu, 2 Apr 2026 09:19:30 -0400
Subject: [PATCH] @W-21861732 fix: convert native mobile rental tenant app
 README from RTF to Markdown

The README was accidentally saved in RTF format, causing rendering
issues. Stripped RTF formatting and restored plain Markdown.
---
 .../native-mobile-rental-tenant-app/README.md | 114 +++++++++++++++++-
 1 file changed, 111 insertions(+), 3 deletions(-)

diff --git a/samples/native-mobile-rental-tenant-app/README.md b/samples/native-mobile-rental-tenant-app/README.md
index f31815b..bdcd8fb 100644
--- a/samples/native-mobile-rental-tenant-app/README.md
+++ b/samples/native-mobile-rental-tenant-app/README.md
@@ -1,9 +1,117 @@
 # Native Mobile Rental Tenant App
 
-A sample Custom Agentic Mobile App (CAMA) for property managers and tenants. Use this as a starting point for building native mobile apps with Salesforce Mobile Publisher, MCF (Mobile Component Framework), and SharedUI.
+A sample Agentic Mobile App metadata project for Salesforce. Demonstrates a rental tenant mobile experience scaffold that you can deploy and extend for native iOS or Android.
 
-## Overview
+## Table of Contents
 
-This sample demonstrates a rental tenant experience—browse properties, submit maintenance requests, pay rent, and communicate with property management—all from a native iOS or Android app.
+1. [What's Included](#whats-included)
+2. [Prerequisites](#prerequisites)
+3. [Quick Start](#quick-start)
+4. [Step-by-Step Setup](#step-by-step-setup)
+   - [1. Authenticate Your Org](#1-authenticate-your-org)
+   - [2. Deploy Metadata](#2-deploy-metadata)
+5. [Testing in the Playground App](#testing-in-the-playground-app)
+6. [Resources](#resources)
 
+---
 
+## What's Included
+
+| Path | Description |
+| ---- | ----------- |
+| `force-app/main/default/digitalExperiences/experiencecontainer/rentalApp/` | Agentic Mobile App Digital Experience metadata for the Rental Tenant app (screen definitions, app metadata, build metadata, and language settings) |
+| `config/project-scratch-def.json` | Scratch org definition file for creating a development org |
+| `sfdx-project.json` | Salesforce project configuration (default package directory, login URL, API version) |
+| `package.json` | Lightweight project scripts for basic build/lint/test placeholders |
+
+---
+
+## Prerequisites
+
+Before you begin, ensure the following are in place.
+
+| Tool | Minimum Version | Install |
+| ---- | --------------- | ------- |
+| [Salesforce CLI (`sf`)](https://developer.salesforce.com/tools/salesforcecli) | v2+ | `npm install -g @salesforce/cli` |
+| [Node.js](https://nodejs.org/) | v22+ | [nodejs.org](https://nodejs.org/) |
+| [Git](https://git-scm.com/) | Any recent version | [git-scm.com](https://git-scm.com/) |
+
+Verify your Salesforce CLI version with:
+
+```bash
+sf --version
+```
+
+---
+
+## Quick Start
+
+Run these commands from this sample directory:
+
+```bash
+sf org login web --alias <alias>
+sf project deploy start --source-dir force-app --target-org <alias>
+```
+
+Replace `<alias>` with your target org alias or username.
+
+---
+
+## Step-by-Step Setup
+
+Use this section if you prefer to run each step manually.
+
+This project is metadata-first and does not require a local UI build step for deployment.
+
+### 1. Authenticate Your Org
+
+Log in to your target org using the Salesforce CLI:
+
+```bash
+sf org login web --alias <alias>
+```
+
+To verify authentication:
+
+```bash
+sf org display --target-org <alias>
+```
+
+If you are working with a sandbox, use:
+
+```bash
+sf org login web --alias <alias> --instance-url https://test.salesforce.com
+```
+
+### 2. Deploy Metadata
+
+Deploy the rental app Digital Experience metadata:
+
+```bash
+sf project deploy start \
+  --source-dir force-app/main/default/digitalExperiences \
+  --target-org <alias>
+```
+
+---
+
+## Testing in the Playground App
+
+After deploying your metadata, you can preview the app on a mobile device using the Salesforce Mobile Playground.
+
+1. In VS Code, open the Command Palette with **Cmd+Shift+P** and run:
+
+   ```
+   SFDX: Open in Live Preview
+   ```
+
+2. A QR code will appear — scan it with your device and follow the on-screen instructions to launch the app in the Playground.
+
+---
+
+## Resources
+
+- [Salesforce Mobile Publisher](https://help.salesforce.com/s/articleView?id=xcloud.branded_apps_exp_cloud.htm&type=5)
+- [Salesforce CLI Setup Guide](https://developer.salesforce.com/docs/atlas.en-us.sfdx_setup.meta/sfdx_setup/sfdx_setup_intro.htm)
+- [Salesforce DX Developer Guide](https://developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/sfdx_dev_intro.htm)
+- [Salesforce CLI Command Reference](https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_top.htm)