Documentation
Preview a commit
Scan a QR to open that commit’s website on your phone. Native plugins are not live.
On Overview, select a commit → Preview this commit.
CapWrap builds only the web layer of that SHA and hosts it on a private, unguessable URL for 7 days. The card shows a QR code and a copyable link. Scan with your phone. A thin CapWrap chrome wraps the page.
What preview is good for
- Does this Lovable commit actually boot?
- Layout on a real phone screen
- Sharing a WIP URL with a teammate
What preview is not
Plugins are not live
Camera, push, in-app purchases, filesystem, and other Capacitor plugins do not run. You are looking at a hosted website, not a TestFlight build. Auth walls in your app still apply — if the site redirects to login with no test user, the preview will look empty.
Revoke the link from the same card when you are done. Failed builds show the error on the commit — you will not get a silent dead QR.
How the build runs
- If the repo has the preview GitHub workflow, Actions builds and uploads
dist. - Otherwise CapWrap clones the SHA and runs install + production build (and injects app config keys).
Customer preview workflows do not automatically receive the env vault. Prefer the CapWrap fallback preview if you need those keys, or add secrets to GitHub yourself.