Troubleshooting

Last updated May 3, 2026 [email protected]

Common issues and the fixes. If yours is not here, email [email protected].

Build failed in EAS

The most common causes:

• Bundle identifier mismatch. The Bundle ID set in Nova8 Settings must exactly match the one in App Store Connect. Re-check both, then retry.
• Expired Apple Developer membership. Open App Store Connect → Membership. If it shows expired, renew, wait 5 minutes, then retry.
• Transient network blip in EAS. Most EAS errors fix themselves on retry. Click Retry build.
• Missing capability. If the agent added Sign in with Apple, push, or in-app purchases, you may need to enable the matching capability in Apple Developer → Identifiers.

TestFlight build does not appear

• Apple processes builds for 5–30 minutes after upload. Check the Activity tab in App Store Connect.
• If the build shows “Invalid Binary”, Apple emails you the reason. Common: missing privacy policy URL, missing icon size, or the export-compliance flag.
• Pull-to-refresh the TestFlight app on your iPhone — sometimes the cache is just stale.

In-app purchase shows “Cannot connect to iTunes Store”

• You are testing on a real device with a sandbox tester account, right? IAPs do not work in the simulator.
• The product ID in RevenueCat must exactly match the one in App Store Connect — case-sensitive, no trailing spaces.
• The product status in App Store Connect must be Ready to Submit. If it shows Missing Metadata, fill in the localized name and description first.
• Apple’s sandbox sometimes lags. Wait 30 minutes after creating a product before testing.

Apple Sign-In returns “Sign-in not available”

Enable the Sign in with Apple capability in your Apple Developer account under Identifiers → your app ID → Capabilities. Then retrigger an EAS build.

Preview shows blank screen

• Check the Logs tab in the workspace — runtime errors print there.
• If a recent agent turn looks broken, undo to the previous turn (each turn is a checkpoint).
• Hard-refresh the preview tab with ⌘⇧R.

Out of credits mid-build

Top-up packs land instantly. Open Billing → Top up and pick a pack. Your in-flight prompt resumes once the credits hit.

Cannot push to GitHub

• You are on Pro or Studio, right? GitHub push is not on Free or Starter.
• Re-authorize the GitHub OAuth app under Settings → Connected accounts. Tokens expire periodically.
• The repo must exist (or you must grant Nova8 the “create repo” scope).