PranavNagrecha/AwesomeSalesforceSkills / skills/admin/fsl-mobile-app-setup
fsl-mobile-app-setup
VerifiedUse this skill when configuring, extending, or troubleshooting the Salesforce Field Service (FSL) Mobile app for field technicians — including offline priming strategy, app extensions, deep linking, and custom branding. Trigger keywords: FSL mobile, Field Service mobile app, offline priming, mobile extension toolkit, app extensions for field service. NOT for coding the LWC quick action or offline extension itself — use apex/fsl-mobile-app-extensions. NOT for technician job lifecycle, signature capture, or parts consumption — use admin/fsl-mobile-workflow-design.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 15.1 KB |
| references/examples.md | markdown | 7.0 KB |
| references/gotchas.md | markdown | 5.1 KB |
| references/llm-anti-patterns.md | markdown | 7.7 KB |
| references/well-architected.md | markdown | 5.1 KB |
| scripts/check_fsl_mobile_app_setup.pyexecutable | script | 6.8 KB |
| templates/fsl-mobile-app-setup-template.md | markdown | 4.5 KB |
templates/fsl-mobile-app-setup-template.md
View on GitHub# FSL Mobile App Setup — Work Template
Use this template when planning, configuring, or reviewing an FSL Mobile deployment or extension.
## Scope
**Skill:** `fsl-mobile-app-setup`
**Request summary:** (fill in what the user asked for)
**In scope:**
- [ ] Offline priming configuration
- [ ] App extensions (LWC Quick Actions / HTML5 toolkit)
- [ ] Deep linking
- [ ] Custom branding
- [ ] Troubleshooting existing deployment
---
## Prerequisites Check
| Item | Status | Notes |
|---|---|---|
| Field Service license provisioned | | |
| Field Service Mobile license provisioned | | |
| Target users have Field Service Mobile permission set | | |
| FSL Mobile app version on device | | |
| Mobile App Plus add-on (required for branding) | | N/A if branding not in scope |
---
## Offline Priming Configuration
### Priming Hierarchy
| Level | Object | Enabled? | Notes |
|---|---|---|---|
| 1 | ServiceResource (technician) | | Base — always required |
| 2 | ServiceAppointment | | |
| 3 | WorkOrder | | |
| 4 | WorkOrderLineItem | | |
### Related Lists in Priming
| Object | Related List | Max Records per List | Notes |
|---|---|---|---|
| WorkOrder | | | Max 50 per list |
| WorkOrder | | | Max 50 per list |
| ServiceAppointment | | | Max 50 per list |
### Page Reference Budget
| Scheduling Window (days) | Appointments/Day (avg) | WOs/Appointment (avg) | Line Items/WO (avg) | Related List Records (total) | Estimated Page Refs | Status |
|---|---|---|---|---|---|---|
| | | | | | | Target: < 1,000 |
**Calculation:**
```
Page Refs ≈ (Appointments) + (Appointments × WOs/Appt) + (Appointments × WOs/Appt × LineItems/WO) + (Related List Records)
```
---
## App Extensions
### Extension Inventory
| Extension Name | Type (LWC / HTML5) | Target Object | Action Name | Status |
|---|---|---|---|---|
| | | | | |
### Extension Type Decision
**Reason for LWC Quick Action:** (fill in — default choice for all new extensions)
**Reason for HTML5 Toolkit (if applicable):** (fill in justification — should only be used for legacy or specific edge cases)
### LWC Quick Action Checklist
- [ ] LWC accepts `@api recordId`
- [ ] Data reads use `@wire` / `uiRecordApi` (not imperative Apex)
- [ ] Data writes use `createRecord` / `updateRecord` (benefits from LDS offline queue)
- [ ] Quick Action registered on target object (type: Lightning Web Component)
- [ ] Quick Action added to FSL Mobile action list in Field Service Mobile Settings
---
## Deep Link Specification (if in scope)
| Item | Value |
|---|---|
| URI scheme | (from Field Service Mobile connected app) |
| Target object type | |
| Target action | |
| Parameters included | |
| Estimated payload size | Must be < 1 MB |
| Source app | |
- [ ] Deep link payload verified < 1 MB with worst-case data
- [ ] Tested on physical device (iOS / Android)
---
## Custom Branding (if in scope)
| Item | Value |
|---|---|
| Mobile App Plus add-on confirmed | Yes / No |
| Logo file | (filename, dimensions) |
| Primary color hex | |
| Splash screen asset | |
- [ ] Mobile App Plus license confirmed before beginning
- [ ] Assets uploaded in Field Service Mobile Settings → Branding
- [ ] Connected app republished after branding changes
- [ ] Branding verified on physical device after reinstall / cache clear
---
## End-to-End Test Results
| Test | Result | Notes |
|---|---|---|
| Full priming sync on test device | Pass / Fail | |
| Offline record access — appointments | Pass / Fail | |
| Offline record access — work orders | Pass / Fail | |
| Offline record access — line items | Pass / Fail | |
| Offline write + sync back to org | Pass / Fail | |
| Quick action renders correctly offline | Pass / Fail | |
| Deep link navigates to correct record | Pass / Fail | (if in scope) |
| Custom branding displays correctly | Pass / Fail | (if in scope) |
---
## Review Checklist
- [ ] Field Service and FSL Mobile licenses confirmed on user profiles
- [ ] Offline priming hierarchy configured (resource → appointments → work orders → line items)
- [ ] Each related list in priming has ≤ 50 records in production data range
- [ ] Total estimated page references per resource < 1,000
- [ ] App extensions use LWC Quick Actions (or HTML5 with documented justification)
- [ ] Deep link payloads < 1 MB (if applicable)
- [ ] Custom branding only configured with Mobile App Plus add-on (if applicable)
- [ ] End-to-end offline test completed on physical device
- [ ] Technician user profiles have correct permission sets and app access
---
## Notes
(Record any deviations from the standard pattern and why.)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |