Skip to content

docs(vue): add troubleshooting entry for blank screen in Capacitor builds#4505

Open
ShaneK wants to merge 1 commit into
mainfrom
FW-6808
Open

docs(vue): add troubleshooting entry for blank screen in Capacitor builds#4505
ShaneK wants to merge 1 commit into
mainfrom
FW-6808

Conversation

@ShaneK
Copy link
Copy Markdown
Member

@ShaneK ShaneK commented May 15, 2026

resolves #2106

Adding documentation to help troubleshoot white screens with Vue builds in Capacitor

@ShaneK ShaneK requested a review from a team as a code owner May 15, 2026 18:04
@ShaneK ShaneK requested a review from thetaPC May 15, 2026 18:04
@vercel
Copy link
Copy Markdown

vercel Bot commented May 15, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
ionic-docs Ready Ready Preview, Comment May 15, 2026 6:05pm

Request Review

Copy link
Copy Markdown
Contributor

@thetaPC thetaPC left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, with minor suggestion


In a Capacitor build the bundled assets are served from a local origin (`capacitor://localhost` on iOS and `https://localhost` on Android by default), so the prefixed paths never resolve and the app fails to bootstrap.

To fix it, reset `base` to `/` (or remove the option) before running `npx cap copy`. If you need both targets, keep a separate config file for each and select it at build time with `vite build --config`.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's also add the code block for this like you did above. It makes it easy for the dev to quickly copy it and paste it.

Suggested change
To fix it, reset `base` to `/` (or remove the option) before running `npx cap copy`. If you need both targets, keep a separate config file for each and select it at build time with `vite build --config`.
To fix it, reset `base` to `/` (or remove the option) before running `npx cap copy`.
```js
// vite.config.js
export default defineConfig({
base: '/',
});
```
If you need both targets, keep a separate config file for each and select it at build time with `vite build --config`.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Vue PublicPath Docs/Troubleshooting

2 participants