Neolithic Prancing Minotaurs


    3.0.2 • Public • Published

    Cap Sync Version (CLI)

    This CLI syncs the npm package version to the capacitor android and ios projects.

    Capacitor creates a folder for each platform in the root of your project, like android, ios, and electron. Since electron is in beta right now, it's not supported by this tool.

    Capacitor does not deal with syncing the version number from your package.json to the mobile projects, mainly because this sync is not 1 to 1 possible without assumtions. This cli uses an automatic alogrithm to calculate the android versionCode based on the version string from package.json. The android versionCode is an ever increasing integer-32 defining the unique version for each app.

    Required Setup for Android

    1. Create a file called under ./android/app/.

    2. Add the following two properties to the file

      versionName: 0.0.1
      versionCode: 1

      Note: These values will be overwritten with the next call to this cap-sync-version cli.

    3. Load the file in ./android/app/build.gradle by adding the following after apply plugin: '' at the top

      // This loads the custom file for applying it's values
      def appProperties = new Properties();
      file("").withInputStream { appProperties.load(it) }
    4. Use these new properties to set versionCode and versionName in ./android/app/build.gradle

      defaultConfig {
          versionCode appProperties.getProperty('versionCode').toInteger()
          versionName appProperties.getProperty('versionName')

    Required Setup for iOS

    None that I'm aware of

    CLI Usage

    $> cap-sync-version --help
    Usage: cap-sync-version [options]
      -v, --version                   output the version number
      -a, --android                   Sync package version to android. It will not update iOS, unless --ios is specified. (default: false)
      -p, --android-allow-prerelease  Note: This flag is disabled since 2.0.0 and will be ignored, because it produced unrelieable version codes in android.  (default: false)
      -i, --ios                       Sync package version to ios.  It will not update Android, unless --android is specified. (default: false)
      -plist, --plist [files...]      Add additional plists to modify (ios only) (default: false)
      -h, --help                      display help for command
      General Information:
                Version: 2.0.2
                Purpose: This CLI syncs the npm package version to the capacitor android and ios projects.
                Default Behavior: syncs the package version to android and ios, if available


    Big Thanks for Contributions to

    Package created after:

    Pure ESM Package modeled after:
    Sindre Sorhus - Pure ESM Package


    All notable changes to this project will be documented here. The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

    [3.0.2] - 2021-07-10

    • Update Dependencies:

      • commander to 8.0.0
      • some npm audit fix updates
      • xo linting package
    • includes PR 13 by Lucas Zeer

      • fixes commander 7.X options handling change (new: cli.opts property)
      • fixes handling of default plattforms to update npm version for

    [3.0.1] - 2021-05-29

    • Fixed Version Numbers in Changelog for 3.0.0 & 3.0.1

    [3.0.0] - 2021-05-29

    • Contribution by Lucas Zeer: Possibility to add additional Plist files on iOS as targets for version sync
    • BREAKING CHANGE: This CLI is now a pure ESM Package, which means, it needs NodeJS > 12.20 to run (see 'engines' field in package.json for more details)
    • Updated all dev & normal dependencies to fix security problems
    • fix version reporting for cap-sync-version cli

    [2.0.3 & 2.0.4] - 2020-04-24

    • Update readme

    [2.0.2] - 2020-04-24

    • Add tests for buildAndroidVersionCode function to make sure all android version code generation works correctly and especially continuously

    [2.0.1] - 2020-04-24

    • Updates for Readme & Changelog

    [2.0.0] - 2020-04-24

    • prohibit generating versions with prerelease part
    • removes all code for prerelease versionCode generation for android to avoid instabilities in the version code

    [1.0.1] - 2020-04-22

    • Improve Badges in Readme

    [1.0.0] - 2020-04-22 - Initial Release

    • Feature: ability to sync versions of android and ios capacitor projects with the npm package version

    [0.0.0] - 2020-04-22 - Initial Package Version

    Initial Package Creation


    Why is there no prerelease support on android anymore since version 2.0?

    Note: Periods in example android version codes are for better readability

    1. A version of 2.3.5-0 would have a version code of 2.030.500 and the version 2.3.5 would also have the version code 2.030.500, since the prerelease digits are zero per default.
    2. A version of 2.3.5-1 would have a higher version code as 2.3.5, even though 2.3.5 is the final version of 2.3.5-1. Version 2.3.5-1 would have the code 2.030.501, but version 2.3.5 would have the code 2.030.500, which would result in rejection of the built apk or aab by the google play console.
    3. iOS is not able to encode prerelease versions like this altogether.

    One could fix above errors, but not without making the version generation algorithm more complicated and less intuitive. And when looking at the fact, that iOS doesn't even support prerelease versions, I'll simply increase the headroom of patch versions (where the developer can decide to mark them as beta or something).


    npm i cap-sync-version

    DownloadsWeekly Downloads






    Unpacked Size

    18.5 kB

    Total Files


    Last publish


    • bjesuiter