capacitor.config.ts

capacitor.config.ts

capacitor.config.ts: appId, appName and webDir

cap init writes the smallest valid configuration, typed by CapacitorConfig so your editor checks options:

capacitor.config.ts as generated by cap initJavaScript

import type { CapacitorConfig } from '@capacitor/cli';
const config: CapacitorConfig = {
  appId: 'com.example.booknest',
  appName: 'BookNest',
  webDir: 'dist'
};
export default config;

appId is the Android application ID and iOS bundle ID, fixed once the app is first published. The CLI checks it against both platforms' rules, so npx cap init BookNest com.example.book-nest stops with Invalid App ID "com.example.book-nest": no dashes, at least two segments, each starting with a letter, only letters, digits and underscores. appName is the name under the launcher icon. webDir is the build folder, relative to the config file.

Only webDir stays live. The CLI writes appId and appName into the native project once, during cap add: namespace and applicationId in android/app/build.gradle, the package of MainActivity.java, and app_name in res/values/strings.xml. Later edits to the config change none of those files, so settle the ID (on a domain you control, not com.example) before adding a platform.

MENU