Introduction #
Creating iOS and Android builds for your Learndash App is fast and code-free with our cloud-based build system.
This guide shows you how to connect your site, prepare your app, and request builds for testing or app store submission.
How the Build Process Works #
Each build compiles your site’s settings—menus, branding, and any GitHub customizations—into installable app files. Test Builds are used for internal QA, while Release Builds are for submission to the App Store and Play Store.
Complete Pre-Build Setup #
Before building, ensure the following are configured:
- Connect your app under Learndash App > Configure > Connect
- Register iOS test devices under Learndash App > Configure > iOS Devices
- Add menus via Learndash App > Menus > Tab Bar and More Menu
- Upload branding assets under Learndash App > Branding > Images
Note: Menus can be updated later without a rebuild. However, changes to branding (like app icons or splash screens) require a new build.
Register iOS Test Devices #
- Go to Learndash App > Configure > iOS Devices > Add New Device.
- Add the device name > Click Next.
- Scan the UDID QR code to register your device.
Note: iOS devices must be registered before installing test apps. Android testing doesn’t require registration.
Request a Build #
- Go to Learndash App > Builds and click Request Build
- Choose the platform(s): iOS, Android, or both
- Select Build Type: Test (for sideloading) or Release (for app store)
- Click Next, review settings, then click Send Build Request
Note: Builds typically complete in 15–30 minutes. Use Recheck Status Now to refresh progress.
After the Build Completes #
- Test Builds: Install directly using the Install Test App button
- Release Builds: Download the .ipa or .apk or use the Publishing Tool to submit to app stores
Note: You can create up to 20 builds per month. If you need more, contact support.
Troubleshooting and FAQs #
Q: Why did my build fail?
A: Make sure the Connect and Configure steps are complete, including App ID, App Key, branding, and iOS device registration.
Q: Do I need to rebuild for menu changes?
A: No, changes to Tab Bar or More Menus sync automatically.
Q: How many builds can I create each month?
A: You can create up to 20 builds. Reach out if you need more.
Q: My iOS Test App won’t install. What’s wrong?
A: Confirm the device is registered under Configure > iOS Devices, then request a new Test Build.
Q: I submitted a Release Build but got rejected.
A: Use the Publishing Tool for guided submissions with pre-checks that reduce the chance of rejection.