Building & shipping a mobile app

    Atlarix can scaffold, run, and upgrade Capacitor-based mobile apps. Here's how to build one and keep it current.

    Overview

    Atlarix wraps your web app with Capacitor so it can run as a native iOS/Android app. The agent can scaffold the native projects, sync web assets, and run the app on a simulator or device.

    Troubleshooting

    If a mobile build fails:

    • Sync first: run a Capacitor sync so native projects pick up the latest web build.

    • Toolchain: iOS needs Xcode + CocoaPods; Android needs Android Studio + an SDK/emulator. Make sure these are installed.

    • Clean build: delete the platform build folders and rebuild if you see stale-artifact errors.

    • Read the error: the terminal output names the failing step — share it with support@atlarix.dev if you're stuck.

    Upgrading your app

    When a new Capacitor or plugin version is available, ask the agent to upgrade: it will bump dependencies, run the migration, sync the native projects, and verify the app still builds. Always test on a simulator/device after an upgrade before shipping.