Skip to main content
Once your application has passed AIWA’s Mobile Readiness Scan, you can prepare it for iOS. AIWA can take your mobile-ready application and generate the iOS build files, or let you download the mobile source files so you can continue through your own development workflow. Scan. Build. Export. Take your AIWA project toward iOS.
iOS export is available on the AIWA Agency plan.

Before You Export

Your application should first pass the Mobile Readiness Scan. The flow is:
If AIWA identifies readiness issues, resolve them first. Once the project is determined to be ready, you can move to the iOS export options.

Your Project Is Mobile-Ready

After a successful readiness scan, AIWA gives you the next actions for mobile export. Aiwa Ios Ready From here, you can choose: Build the iOS app Let AIWA generate the iOS build files. Download the source Take the generated mobile project files into your own development workflow. Conceptually:

Option 1: Build the iOS App

Choose Build App when you want AIWA to generate the iOS version for you. AIWA handles the build process from the mobile-ready project.
You don’t need to create a separate iOS project manually before starting the build.

Start the iOS Build

From the Mobile Export interface, choose the iOS build option. Aiwa Ios Generate AIWA begins preparing the iOS version of your application. Wait for the current build to finish before starting another export.

When the Build Is Ready

Once AIWA successfully completes the process, the iOS build files become available for download. Aiwa Ios App Built Your workflow becomes:
At this point, the iOS build has been generated. Store distribution is a separate process.

Apple Developer Account

If you eventually want to distribute the application through Apple’s App Store, you’ll need your own Apple Developer account. AIWA doesn’t replace Apple’s developer enrollment or App Store distribution process. Conceptually:
Your Apple Developer account is handled outside AIWA and is required when you’re ready to take an exported app toward App Store distribution.

Option 2: Download the Source Files

You can also download the mobile source files instead of relying only on AIWA’s generated build.
[INSERT SCREENSHOT 4: Download Source Files option] This can be useful when you want more control over the mobile project.

Why Download the Source?

Source export can be useful when you want to:
  • Continue development outside AIWA
  • Review the generated mobile project
  • Make custom mobile changes
  • Hand the project to an iOS developer
  • Manage your own build process
  • Maintain your own release workflow
  • Prepare the application for Apple-specific distribution steps
This gives agencies and development teams more flexibility.

Build vs Download Source

The choice is straightforward. Build App Use AIWA to generate the iOS build.
Download Source Take the mobile project files into your own workflow.
Both start from the same mobile-ready AIWA project.

Test the iOS Experience

Generating the files isn’t the same as validating the application. Before moving toward public distribution, test the iOS experience thoroughly. Check:
  • Authentication
  • Navigation
  • Forms
  • Database interactions
  • Buttons and touch interactions
  • Uploads
  • Images
  • External links
  • Integrations
  • Mobile layouts
  • Critical product workflows
Your goal is to verify that the application works as a product, not simply that a build was generated.

Test Authentication

Authentication deserves particular attention on mobile. Test:
Also test any external authentication flows your application uses. If users can sign in on both web and mobile, confirm that they can access the appropriate existing account data.

Test Your Database Workflows

If your application uses Neon Postgres, verify that the mobile app can work with the application’s data correctly. For example:
If the same product also exists on the web, verify that information remains consistent where your architecture is designed to share data.

Test External Integrations

If your application uses connectors, test the workflows from the mobile experience too. For example:
  • Stripe
  • Resend
  • Twilio
  • Cloudinary
  • AI providers
  • Calendly
  • Google services
Don’t assume that an integration working correctly in the web experience automatically means the mobile workflow is ready. Some functionality may leave the application temporarily. For example:
Test things such as:
  • Payments
  • Scheduling
  • Authentication
  • Documents
  • External websites
Make sure the overall flow is understandable for the user.

Mobile Payments

Payments require extra attention for App Store-distributed products. The rules can depend on what the application sells. There may be important differences between:
  • Physical products
  • Real-world services
  • Digital subscriptions
  • Digital features
  • In-app content
Before distributing an app through Apple’s App Store, review Apple’s current payment requirements for your specific product. A payment workflow that works on the web may not automatically be appropriate for App Store distribution.

Fixing Problems After Export

If you find an issue in the generated iOS version, return to the AIWA project and describe the problem. For example:
The application passed Mobile Readiness, but on the iOS build the login form is partially hidden when the keyboard opens. Fix the mobile layout without changing the desktop experience.
Then repeat:
You don’t need to rebuild the product from scratch.

If the iOS Build Fails

If AIWA fails to generate the iOS build, use any error information shown. For example:
Expected: The mobile-ready project should generate the iOS build. Mobile Readiness: Passed Actual: The iOS build starts but fails before the files become available. Error: [PASTE ERROR] Debug the iOS build issue without changing unrelated application functionality.
This gives AIWA a focused problem to investigate.

Re-Exporting After Changes

Your iOS application can evolve alongside the project. For example:
For each significant mobile release:
This keeps the mobile product aligned with your AIWA project.

Web and iOS Can Be the Same Product

Your product can exist across both experiences.
For products designed around shared accounts and backend data, users can access the same application from different platforms.

iOS Export for Agencies

For agency work, decide ownership before taking the application toward public distribution. Clarify:
  • Who owns the app?
  • Whose Apple Developer account will be used?
  • Whose branding should appear?
  • Who manages future releases?
  • Who handles App Store requirements?
  • Who maintains the application?
For a client-owned app, a workflow might be:

iOS Export vs App Store Distribution

AIWA’s iOS export and Apple’s App Store submission are separate processes. AIWA
Apple
AIWA currently handles the product-building and export side. Apple controls App Store distribution and approval.

Store Approval Is Separate

A successful AIWA export doesn’t guarantee App Store approval. Apple has its own requirements related to areas such as:
  • Developer enrollment
  • Application functionality
  • Store metadata
  • Privacy
  • Data handling
  • Permissions
  • Payments
  • Content
  • Review policies
These requirements can change over time.
Always check Apple’s current App Store requirements before submitting an application.

Before Moving Toward the App Store

Before beginning Apple’s distribution process, confirm:
  • Mobile Readiness passed
  • iOS build generated
  • Core application works
  • Authentication works
  • Navigation works
  • Database functionality works
  • Integrations work
  • Mobile layouts work
  • Critical workflows work
  • External links work
  • No sensitive credentials are exposed
  • The application has been tested
You should be confident in the product before beginning store distribution.

Complete iOS Export Workflow

The AIWA workflow is:
And if you later want App Store distribution:

Next: Submitting to the App Store

Next, we’ll cover what happens outside AIWA when you take your exported iOS application toward Apple’s App Store.

Submitting to the App Store

Prepare your exported iOS application for Apple’s App Store distribution.