Overview

Overview is the ship desk for one app. The left sidebar also has Store listings, History, Integrations, and Settings.

Setup checklist

Until the project can be deployed, a small Get ready to ship popup stays anchored at the bottom-right. It lists what’s left — Capacitor, store listings, Apple and Google settings, and the pipeline — even when the native apps already exist. Steps for a platform you turned off, or that the repo does not have, are left out. Close it and a smaller chip stays in that corner; open the chip to bring the list back. The pipeline row installs onto the default branch in one click. The last step, Start your first deployment!, selects the newest commit. The popup hides once every required step is done.

The badge beside the app name says Ready to publish only when Capacitor, the store settings, and the pipeline are in place. If Capacitor is there but something is still missing, it says Needs setup. A website with no Capacitor says Web only. See Your first app.

Branch and commits

CapWrapp lists branches from GitHub, then recent commits on the branch you pick. The SHA is the exact snapshot you will preview or ship. Lovable’s latest push shows up here after GitHub has it — refresh if you just pushed.

Select a commit to:

• Read the message
• See package version drift for that SHA
• Preview this commit — QR / link (details)
• Upload for testing — start TestFlight / Play Internal (details)

Live deploy

If a store build is running, Overview shows its step timeline (checkout → web build → iOS / Android upload → ready). You can leave the page; History keeps the run. Open the GitHub Actions URL from the run for the raw log.

Package versions

CapWrapp checks official Capacitor packages (and Capgo packages if present) against npm. It does not scan your whole lockfile. An upgrade opens a pull request on capwrapp/capacitor-deps — it never commits to your default branch by itself. A major bump of @capacitor/core is a native store ship, not a live-update-only change.

Reconnect GitHub

If tokens expire or you revoked the GitHub App, Overview asks you to reconnect. Use Add app / Account → GitHub App → Manage.