Capacitor: Invalid App ID

What this error means

The appId also has to be a valid Android package name: letters and numbers, dots between parts, no hyphens.

Why it happens

Capacitor checks the appId as an Android package name before it writes the native projects. Hyphens and other illegal characters fail that check.

The message tools print

[error] Invalid App ID "com.my-studio.harbor". Must be in Java package form with no dashes (ex: com.example.app)

How to fix it

1. Change appId in capacitor.config to something like com.studio.myapp.
2. Check it with the appId validator before you create store records — it’s permanent after that.

The Capacitor appId and bundle ID validator checks the appId and webDir before you create store records.

Check a log that shows this

Paste the failing step into the build error explainer. It matches this message, and any others in the same log, in your browser. Nothing is uploaded.

Other Web build errors

• npm ci needs an existing package-lock.json
• npm ci: lockfile is out of sync with package.json
• npm ERESOLVE unable to resolve dependency tree
• JavaScript heap out of memory
• Rollup failed to resolve import
• error TS: TypeScript errors stop the build
• Could not find the web assets directory