Mobile and Offline Developer Guide

Mobile App Development with Lightning Web Components and LWC Offline
Create Mobile-Ready Components
Use Mobile Device Features in Mobile Apps
Offline Considerations and Limitations
Offline Environment Details
Use Salesforce Features While Offline
Development Tools and Processes
Understand the Mobile Development Cycle
Set Up Your Development Environment
Preview Components on Mobile
Mobile Development Preview Environments
Preview in the Salesforce Mobile App
Validate Lightning Web Components for Offline Use
Develop Offline-Ready LWCs with the LWC Offline Test Harness
Debug Mobile Components
Customize the Offline Experience for the Salesforce Mobile App
Use MCP Tools for Mobile LWC and Offline Development (Beta)
Salesforce Mobile App Generation (Developer Preview)
Quick Start Tutorials
PDF

Newer Version Available

This content describes an older version of this product. View Latest

Mobile Development Preview Environments

To preview and iterate on components in a real-time preview, use Local Dev. Developers can also preview components in context in the Salesforce mobile app, or in a virtual device build of the Salesforce mobile app. Salesforce admins can preview Lightning Experience on mobile from Lightning App Builder.

Administrators

Salesforce Administrators work with stakeholders to define requirements and to customize their org, using the full variety of tools available in Salesforce. When customizing pages, administrators should validate their changes for both desktop and mobile.

App Builder Mobile Previews

Admins can use Lightning App Builder to build apps and pages to customize Lightning Experience on mobile. App Builder provides previews for both desktop and mobile. Admins can specify certain components as mobile- or desktop-only. See Visibility Rules on Lightning Pages for available filtering options.

For more information about building and previewing pages in App Builder, see Build a Mobile App Page and Get Ready for Lightning — 5 step-by-step videos.

Preview components in Lightning App Builder

If admins need more than a preview, they can run Lightning applications and components in the Salesforce mobile app on their devices. Testing in the mobile app helps validate that users have the best experience on mobile.

Developers

Salesforce developers building Lightning web components have many options available to validate their components for mobile.

Preview Components Using Local Dev

Starting on September 5, 2025, the Local Development Server will not be available to use. To continue testing your Lightning web components in a real-time browser preview, migrate to the new Local Dev experience.

Important

With Local Dev, you can preview your Lightning web components in isolation or within a Lightning app or Experience Cloud Lightning Web Runtime site. When you save changes to your source code on your local machine, Local Dev automatically updates your browser preview. This lets you iterate quickly on your components without deploying code or manually refreshing the preview in your browser.

Preview a component, app, or site in a desktop or mobile environment using Local Dev.

You can use Local Dev to test a Lightning app in different mobile environments. This requires some setup of mobile development tools, like Xcode and Android Studio. For a hands-on walkthrough of this setup, complete the Trailhead project Set Up Your Salesforce Mobile Developer Tools for Lightning Web Components.

To learn more about Local Dev, check out Lightning Web Components Developer Guide: Preview Components with Local Dev.

Preview in the Salesforce Mobile App

Previews using Local Dev are great for seeing your changes in real-time. After your component is validated locally, publish it to a Salesforce development org and validate it on pages with other components in the Salesforce mobile app. You can run the Salesforce mobile app on physical devices and on virtual devices.

  • Physical Devices

    You can run your Lightning applications and components using the Salesforce mobile app on your device. Use the mobile app to review issues your applications and components encounter on mobile. The Salesforce mobile app is available for download from the App Store and Google Play.

    Preview components in the Salesforce mobile app
  • Virtual Device Builds

    You can run your Lightning applications and components using virtual device builds of the Salesforce mobile app. These builds make it possible to run Salesforce on iOS simulators and Android emulators so you can validate and debug your components on many devices. To learn how to download virtual device builds, see Preview Components in the Salesforce Mobile App.

    Preview components using virtual device builds