{"id":15564,"library":"capacitor-identity","title":"Capacitor App Identifier and Name Updater","description":"capacitor-identity is a focused command-line interface (CLI) tool designed to simplify the process of updating the application ID (bundle identifier for iOS, `applicationId` for Android) and the display name (`appName`) for Capacitor-based mobile applications. Currently at version 1.0.4, it serves as a utility for developers needing to quickly configure their Capacitor projects for different environments (e.g., staging vs. production) or rebranding efforts. Its primary differentiator is its simplicity and direct approach to modifying core native project settings without requiring manual edits in Xcode or Android Studio. It is executed via `npx` and directly manipulates the necessary configuration files within the Capacitor project structure. The package is likely updated on an as-needed basis to support new Capacitor versions or address specific platform changes, rather than following a frequent release cadence, given its specialized function.","status":"active","version":"1.0.4","language":"javascript","source_language":"en","source_url":"https://github.com/aminetchitooss/capacitor-identity","tags":["javascript","capacitor","ios","android","rename","update","channge","rename CFBundleIdentifier","rename CFBundleDisplayName"],"install":[{"cmd":"npm install capacitor-identity","lang":"bash","label":"npm"},{"cmd":"yarn add capacitor-identity","lang":"bash","label":"yarn"},{"cmd":"pnpm add capacitor-identity","lang":"bash","label":"pnpm"}],"dependencies":[],"imports":[{"note":"This package is a command-line interface (CLI) tool and is not intended for direct programmatic import into JavaScript/TypeScript code. It should be executed via `npx` in your project's root directory.","wrong":"import { updateIdentity } from 'capacitor-identity';","symbol":"capacitor-identity (CLI)","correct":"npx capacitor-identity --bundleId com.example.newapp --appName \"New App Staging\""}],"quickstart":{"code":"npx capacitor-identity --bundleId com.example.newapp --appName \"New App Staging\"\n# After running, ensure to sync and rebuild your native projects:\nnpx cap sync\nnpx cap open ios\nnpx cap open android","lang":"javascript","description":"Demonstrates how to update the application bundle ID and display name of a Capacitor project using the CLI tool."},"warnings":[{"fix":"Navigate to your Capacitor project's root directory (where `capacitor.config.ts` or `package.json` resides) before running the command.","message":"Ensure you run `capacitor-identity` from the root directory of your Capacitor project. Executing it elsewhere will result in 'file not found' errors or incorrect modifications.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Always provide both `--bundleId com.your.app` and `--appName \"Your App Name\"` arguments.","message":"The `--bundleId` and `--appName` flags are mandatory for `capacitor-identity` to perform its updates. Omitting either will lead to an `Error: Missing required argument` and the operation will not complete.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Run `npx cap sync` followed by `npx cap open ios` and/or `npx cap open android` in your project root.","message":"After running `capacitor-identity`, it is crucial to rebuild your native projects (`npx cap sync && npx cap open [ios|android]`) to ensure the changes are picked up by Xcode and Android Studio.","severity":"gotcha","affected_versions":">=1.0.0"}],"env_vars":null,"last_verified":"2026-04-21T00:00:00.000Z","next_check":"2026-07-20T00:00:00.000Z","problems":[{"fix":"Change your current directory to your Capacitor project's root, then re-run `npx capacitor-identity ...`.","cause":"The `capacitor-identity` command was executed outside the root directory of a Capacitor project.","error":"Error: ENOENT: no such file or directory, open 'capacitor.config.ts'"},{"fix":"Include the `--bundleId com.your.app` argument in your `npx capacitor-identity` command.","cause":"The `--bundleId` argument was omitted when running the `capacitor-identity` command.","error":"Error: Missing required argument: bundleId"},{"fix":"Include the `--appName \"Your App Name\"` argument in your `npx capacitor-identity` command.","cause":"The `--appName` argument was omitted when running the `capacitor-identity` command.","error":"Error: Missing required argument: appName"}],"ecosystem":"npm"}