Troubleshooting

CapWrap doesn’t list my repo

• Install the GitHub App on the account or org that owns the repo
• Grant that specific repository (or all repos)
• Finish the connect screen after GitHub redirects
• If you only signed in with Google, you still must install the GitHub App

Add Capacitor PR merged, still “web only”

Refresh detection on Overview. Confirm capacitor.config.ts and ios/ or android/ are on the default branch, not only on capwrap/add-capacitor. Paste the follow-up prompt into Lovable if native folders were never committed.

“iOS setup isn’t finished”

No ios/ project in the repo. The init workflow may have failed (open Actions on the wrap branch). Run the follow-up prompt, push, tap Try again.

Pipeline PR open, Ship does nothing useful

Merge onto the default branch. GitHub will not dispatch a workflow that exists only on capwrap/native-pipeline.

Apple save fails / certificate errors

• Admin API key, not App Manager-only, for provisioning
• .p8 matches Key ID
• Team is not at Apple’s Distribution certificate cap with only “dead” certs — CapWrap tries to revoke unused ones; if a human-managed cert is in the way, revoke leftovers in the Apple developer portal
• Bundle ID exists in App Store Connect

Play upload unauthorized

• Service account invited on that Play app with testing-track permission
• Play Android Developer API enabled
• Package name matches
• JSON is the key for that service account
• Internal testing track exists

White screen on TestFlight / preview

Missing app config keys, or the app requires a login the tester does not have. Preview also will not run native plugins.

Web build failed in Actions

The job needs a static index.html. Pure server/SSR apps must emit a client folder (or accept CapWrap’s one-job patch). Open the prepare job log. Locally, npm run build should produce the same folder you set as webDir.

iOS archive failed

Open the macOS job log. Frequent causes: missing ios/, CocoaPods, signing (save Apple setup again), or GitHub macOS minutes exhausted.

Android bundle failed

Keystore password / alias, android/ missing, or Gradle. If you minted a keystore in CapWrap then generated another in Android Studio, Play will reject the upload.

Build succeeded, testers see nothing

Wait for Apple/Google processing. Add yourself as TestFlight internal tester. For Play, use the internal testing opt-in link, not the public Play Store listing.

Need a human

Use Need assistance? in the app sidebar, or the feature roadmap link there if you are requesting a product change.