Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
[This topic is pre-release documentation and is subject to change.]
This article walks you through going from an empty folder to a working app running on a physical device. You create a project from the native template, install the mobile-app plugin in your AI coding host, generate an app from a natural-language description, approve the planning gates, run the app on a device with hot reload, and deploy it to your Power Platform environment. Learn more about mobile-app plugin in Power Apps Standalone App Template.
Step 1: Create the project from the template
Open Command Prompt and run these commands to create the project folder and install the dependencies:
npx degit microsoft/power-platform-skills/plugins/mobile-apps/template#main field-inspector
cd field-inspector
npm install
Step 2: Install the mobile-app plugin
Install the plugin from the Power Platform Skills marketplace.
GitHub Copilot CLI:
copilot plugin marketplace add microsoft/power-platform-skills
copilot plugin install mobile-app@power-platform-skills
Claude Code:
claude plugin marketplace add microsoft/power-platform-skills
claude plugin install mobile-app@power-platform-skills --scope user
Visual Studio Code with Copilot Chat:
- Open the Extensions view.
- Search for
@agentPlugins mobile-app. - Install the extension.
- Reload Visual Studio Code if prompted, then open Copilot Chat in Agent mode.
Step 3: Generate the app
Open the template folder in Visual Studio Code and run the skill from Copilot Chat. From the template folder, in your host, run:
/create-mobile-app "describe what you want"
Examples of sample prompts:
Create an app for a retail store to help the sales manager track orders and manage inventory. Staff scan products by using the native barcode scanner to check stock or log orders.
Create an app for a beverage distributor to help delivery drivers track deliveries and manage stock at retail locations. Enable continuous location tracking so the manager can see each driver's live route and stop history on a map.
Step 4: Sign in and select an environment
Sign in with an account that has access to the target Power Platform environment.
Note
Power Apps CLI and Azure CLI use separate authentication caches. Signing in to one doesn't change the other.
Step 5: Review and approve the planning gates
The plugin generates native-app-plan.md and pauses at each planning gate. Review and approve the plan before continuing.
The approved plan is reused for future /edit-app operations.
Data model: Review the tables, columns, relationships, and alternate keys that the app uses. The generated plan includes an entity relationship (ER) diagram.
Native capabilities: Review the approved native capabilities, such as camera, scanner, or GPS.
Connectors: Review the first-party and custom connectors that are included in the solution.
Screens: Review the screen specifications and navigation flow. Before code is generated, the plugin creates a visual preview in
_plan_preview.html.
Step 6: Configure app registration
Your app needs a Microsoft Entra app registration. The registration gives the app the permissions it needs to run, including in the Power Apps Developer app, so you need one whether or not you plan to wrap the app. Choose one option:
Create a registration (recommended). The plugin opens the app registration page in Power Apps:
make.powerapps.com/environments/<env-id>/wraps#create-app-registration. The address containswraps, but the registration isn't tied to Wrap. Copy the Application (client) ID and paste it into the plugin prompt.Reuse a registration you use with Wrap. If you already wrap other apps (canvas or native), you can use the same registration here. A new registration also works with Wrap.
Configure it later. Run the following command from the project folder before you first sign in on a device:
/set-app-registration-native
Step 7: Wait for scaffolding to complete
After you approve the planning gates, the plugin generates the design system and scaffolds the app.
The process includes the following stages:
Design system generates assets under the
brand/folder, including:design-system.mdfor specstokens.tsfor tokensdesign-system.htmlfor gallery
Initialization runs:
npx power-apps initSchemas and Dataverse
- Generates schemas.
- Creates or reuses tables.
- Regenerates services in
src/generated/services/.
Connectors adds and configures connectors.
Native wrappers generates approved native capability wrappers in
src/native/.Screens generates screens from the approved screen specifications.
Verification runs TypeScript compilation and validation checks.
Preview generates a static
preview.htmlfile.
The time required depends on the complexity of the app. Apps that include Dataverse provisioning, offline profiles, or multiple connectors can take longer to build because other platform activities can affect Dataverse metadata operations.
Step 8: Run the app on a device
Connect your computer and device to the same network. Open Command Prompt in the project folder and run the following command to start the development server:
npm run devWait for the development server to print a QR code.
Open the Power Apps Developer app on your device.
Scan the development server QR code to load the bundle.
Sign in with an account that has access to the selected environment.
The app loads on the device and supports hot reload. Changes made to files in the app/ directory appear without a full rebuild. Keep the development server running while you test.
Connect through a dev tunnel
If the app doesn't load after you scan the QR code, network restrictions might be blocking the connection between your device and computer. Use a private dev tunnel to connect over HTTPS instead of the local network:
Stop the development server by pressing Ctrl+C.
Sign in to Azure CLI and start the development server with tunneling enabled.
az login npm run dev -- --tunnelAfter the tunnel connects, scan the new QR code by using the Power Apps Developer app. Don't reuse the previous QR code.
To use a specific Microsoft Entra tenant, run:
az login --tenant <tenant-id>
npm run dev -- --tunnel --tunnel-tenant <tenant-id>
Replace <tenant-id> with your organization's tenant ID.
Note
Tunnel mode requires outbound HTTPS connections on port 443 with TLS 1.2 or later, to login.microsoftonline.com, global.rel.tunnels.api.visualstudio.com, *.rel.tunnels.api.visualstudio.com, and *.devtunnels.ms. If your network blocks these endpoints, contact your network administrator.
The tunnel is authenticated and deleted when the development server exits. Don't share the QR code publicly.
Step 9: Update the app
Use the following commands to refine the app. Each update is recorded in memory-bank.md.
| Command | Description |
|---|---|
/edit-app "..." |
Updates the plan, applies changes, rebuilds affected screens, and refreshes preview.html. |
/add-dataverse |
Extends the schema and regenerates typed services. |
/add-native camera |
Adds a typed wrapper for a supported native capability. |
/add-connector |
Adds a Power Platform connector by using npx power-apps add-data-source. |
/preview-screens |
Regenerates the static HTML preview without dev server. |
/debug-app "<symptom>" |
Diagnoses issues in a running app by using dev server output. |
Step 10: Deploy your app
From the project folder, run the following command in your AI coding host:
/deploy
When prompted, review and confirm the target environment. The command builds and publishes your app to the Power Platform environment specified in power.config.json. Wait until the build and deployment complete successfully before you continue.
Publishing to Power Platform doesn't create or distribute an installable iOS or Android package. To create an installable package for iOS or Android, use Power Apps Wrap:
- Open Power Apps and select the same environment used for deployment.
- Open Wrap and create or open a Wrap project for the deployed app.
- Configure the target platforms, bundle ID, app registration, branding, and signing settings. Use the app registration configured in step 6.
- Build and sign the package, and then test it on a physical device before distribution.
- Distribute the signed package through your organization's approved channel.
Learn more in Customize and build your mobile app using the wrap wizard.
Step 11: Add push notifications by using Firebase Cloud Messaging
To receive push notifications in your native app, use React Native Firebase for Firebase Cloud Messaging (FCM) and expo-notifications for permissions and foreground notification display.
Important
The Power Apps Mobile Preview app doesn't currently support testing push notifications. You also can't build apps that use push notifications by using the Power Apps Wrap process in step 10. The template's npm run build:android and npm run build:ios commands use Wrap, so they aren't a supported build path for these apps.
From the app directory, install these exact versions:
npm install --save-exact @react-native-firebase/app@25.1.0 @react-native-firebase/messaging@25.1.0 expo-notifications@55.0.23 expo-build-properties@55.0.14Add Firebase client configuration. Register your Android and iOS apps in the Firebase console. Download
firebase/google-services.jsonandfirebase/GoogleService-Info.plistinto your app project. The registered app identifiers must match your app's configuration. For iOS, enable the Apple Push Notifications capability and configure APNs credentials in Firebase. See the Firebase Android integration guide and Firebase Apple integration guide.Update
app.config.js. Merge these settings into the existingcustomizeExpoConfigfunction. Preserve the template'screatePowerAppsExpoConfigcall, app identity, and other settings. Merge existing plugin entries instead of adding duplicates, and include only the Firebase client files for platforms you build.Setting Change pluginsAdd 'expo-notifications','@react-native-firebase/app', and'@react-native-firebase/messaging'.expo-build-propertiespluginAdd ['expo-build-properties', { ios: { useFrameworks: 'static', forceStaticLinking: ['RNFBApp', 'RNFBMessaging'] } }].android.googleServicesFileSet to './firebase/google-services.json'.ios.googleServicesFileSet to './firebase/GoogleService-Info.plist'.ios.entitlements['aps-environment']Set to 'development'for development signing or'production'for distribution signing.ios.infoPlist.UIBackgroundModesAdd 'remote-notification', preserving other modes.Add client-side notification handling. Create a native-only helper such as
src/native/pushNotifications.tsand wire it into your app. See React Native Firebase messaging and Expo SDK 55 notifications for the client-side integration.Subscribe opted-in users to an agreed public topic, or register their FCM tokens through an authenticated backend. Handle
onTokenRefresh, account changes, and opt-out. Topic membership isn't authorization; don't include confidential data in notifications.Rebuild and reinstall your app-specific native binary before testing. JavaScript-only deployment doesn't apply native dependency or configuration changes. Test permissions, foreground display, background delivery, and notification taps on physical devices. Expo Go doesn't include React Native Firebase; don't assume a shared developer player contains your Firebase configuration. The Preview app and Wrap limitations described earlier apply.