React Native Version Bumper

⚡ One-click version bumping for React Native and Expo projects
CodeLens integration • Git automation • Cross-platform sync • Batch preview

✨ Features

⬆️ Version Bumping: Increment versions across Android (build.gradle), iOS (Info.plist), Expo (app.json, app.config.js/ts), and package.json with semantic versioning (major, minor, patch)
🔍 CodeLens: Click ↑ links above version lines for instant updates with auto-detection of project files
🔄 Git Workflow Integration: Create branches, commit changes, tag releases, and push to remote with smart commit messages
📋 Interactive Batch Mode: Preview all file changes and Git operations before execution, then apply everything atomically
📊 Version Overview Dashboard: View current versions across all platforms in a unified interface
⚙️ Auto-Detection: Automatically finds Android, iOS, Expo, and package.json files with support for custom paths and platform skipping
🚀 Expo Support: Also works with Expo projects (app.json, app.config.js, app.config.ts) with optional native file synchronization
🔗 Release Automation: Generate release notes and provide links to create GitHub/GitLab releases and pull requests

🚀 Installation

Install from:

Or install manually:

code --install-extension sandipshiwakoti.vscode-react-native-version-bumper

Requirements:

VS Code 1.74.0 or higher
A React Native project with android/ and/or ios/ folders, or an Expo project with app.json, app.config.js, or app.config.ts
Package.json is optional

⚡ Quick Start

Install from VS Code Marketplace or Open VSX
Open your React Native or Expo project
Press Ctrl+Shift+P (or Cmd+Shift+P)
Type "Version Bumper" and choose your action
Done! All platforms updated and synced with clean commit messages

🎥 See It In Action

⚡ CodeLens: One-Click Version Updates

Click the ↑ arrows above version lines for instant bumps

CodeLens Demo

🔄 Bump All Platforms

Update Android, iOS, and package.json simultaneously

Bump All Demo

⚒️ Complete Git Workflow

Branch creation, commits, tags, and release automation

Bump All Git Demo

🔀 Sync All Platforms

Synchronize versions across all platforms to match

Sync All Demo

📊 Version Overview

Monitor all platform versions at a glance

Version Overview Demo

🚀 Expo Support

Supports Expo projects: configure via app.json, app.config.js/ts with option to sync native Android/iOS files

Expo Demo

📋 Usage

1. Open Your Project

Open a React Native or Expo project in VS Code.

2. Run Commands

Access commands via the Command Palette (Ctrl+Shift+P or Cmd+Shift+P on macOS):

Version Bumper: Bump All
Bumps versions for selected platforms without Git operations.
- Choose bump type (Major, Minor, Patch) for Android/iOS.
- Choose package.json bump type or skip it entirely for this operation.
- Updates version code (Android/iOS) and version name (all platforms).
- View results in a webview (success/failure details).
Version Bumper: Bump All + Git
Bumps versions and performs Git operations.
- Same version bump process as above (with option to skip package.json).
- Additional steps:
  - Create a branch (optional, customizable name).
  - Commit changes (customizable message).
  - Create a tag (optional, customizable format).
  - Push to remote (optional).
- Webview results include links to:
  - Create a Release: For the new tag (e.g., on GitHub or GitLab).
  - Create a Merge Request: For the new branch (e.g., on GitHub or GitLab).
Version Bumper: Sync All
Sync all platforms to the same version.
- Choose source version (package.json, Android, iOS, or custom).
- Preview changes before confirming.
- Updates all platforms simultaneously.
Version Bumper: Sync All + Git
Same as "Sync All" with Git workflow automation.
- Syncs all platforms to the same version.
- Creates branch, commits, tags, and pushes to remote.
Version Bumper: Version Overview
Displays current versions for all platforms in a webview.
Version Bumper: Bump Patch (Current File)
Bumps patch version in the currently active file only (package.json, build.gradle, Info.plist, or Expo config files).
Version Bumper: Bump Minor (Current File)
Bumps minor version in the currently active file only.
Version Bumper: Bump Major (Current File)
Bumps major version in the currently active file only.

Expo-specific features:

All commands work with Expo projects (app.json, app.config.js, app.config.ts)
Optional native file sync: Enable expo.syncNativeFiles to sync Expo version changes to Android/iOS native files
Clean commit messages: Simple messages like chore: bump version to v1.2.0

3. CodeLens (Click ↑ to Bump)

When CodeLens is enabled (default), editing package.json, build.gradle, Info.plist, or Expo config files shows CodeLens links above version fields:

Click ↑ links to bump versions:
- Android/iOS: Shows build numbers (e.g., "↑ Patch (1.0.1 (24))")
- Package.json: Shows version only (e.g., "↑ Patch (1.0.1)")
- Expo: Shows version only (e.g., "↑ Patch (1.0.1)") in app.json, app.config.js, app.config.ts
- Auto-detects: Project files and custom paths
Toggle CodeLens: Use the editor title bar button (circle with upward arrow for enabled, slashed for disabled) to show/hide CodeLens for a cleaner editor view.

Example CodeLens in action:

{
    // ↑ Patch (1.0.1) | ↑ Minor (1.1.0) | ↑ Major (2.0.0)
    "version": "1.0.0"
}

{
    "expo": {
        // ↑ Patch (1.0.1) | ↑ Minor (1.1.0) | ↑ Major (2.0.0)
        "version": "1.0.0"
    }
}

// ↑ Patch (1.0.1 (24)) | ↑ Minor (1.1.0 (24)) | ↑ Major (2.0.0 (24))
versionName "1.0.0"
versionCode 23

<key>CFBundleShortVersionString</key>
<!-- ↑ Patch (1.0.1 (24)) | ↑ Minor (1.1.0 (24)) | ↑ Major (2.0.0 (24)) -->
<string>1.0.0</string>

4. Auto-Detection & What Gets Updated

Android (android/app/build.gradle)

Auto-detects: android/app/build.gradle file
Updates: versionName "1.0.0" and versionCode 23
Custom path: Configure via reactNativeVersionBumper.android.buildGradlePath

iOS (ios/*/Info.plist)

Auto-detects: Info.plist in ios/YourAppName/ or ios/ folder
Updates: CFBundleShortVersionString (version) and CFBundleVersion (build number)
Smart Variables: Automatically detects and handles iOS variables like $(MARKETING_VERSION), $(CURRENT_PROJECT_VERSION) - updates project.pbxproj when variables are found
Flexible: Works with direct values or any $(...) variable pattern
Custom path: Configure via reactNativeVersionBumper.ios.infoPlistPath

Package.json (optional)

Auto-detects: package.json in project root
Updates: "version": "1.0.0"
Skip: Set reactNativeVersionBumper.skipPackageJson: true

Expo (app.json, app.config.js, app.config.ts)

Auto-detects: Expo configuration files in project root
Updates: "version": "1.0.0" in expo config
Native Sync: Optional sync with Android/iOS files (enable expo.syncNativeFiles)
CodeLens: Shows ↑ arrows above version lines in Expo config files

5. Status Bar

Click the status bar item to quickly see the current package.json version or trigger the "Version Overview" command.

⚙️ Configuration

Adjust settings in settings.json to fit your workflow:

Setting	Description	Default
`reactNativeVersionBumper.skipPackageJson`	Skip `package.json` version bump	`false`
`reactNativeVersionBumper.skipAndroid`	Skip Android version bump	`false`
`reactNativeVersionBumper.android.buildGradlePath`	Path to `build.gradle`	`"android/app/build.gradle"`
`reactNativeVersionBumper.skipIOS`	Skip iOS version bump	`false`
`reactNativeVersionBumper.ios.infoPlistPath`	Custom path to `Info.plist` (auto-detected if null)	`null`
`reactNativeVersionBumper.ios.projectPbxprojPath`	Custom path to `project.pbxproj` (auto-detected if null)	`null`
`reactNativeVersionBumper.git.commitMessagePrefix`	Commit message prefix (system adds smart version suffix)	`"chore: bump version to "`
`reactNativeVersionBumper.git.syncCommitMessagePrefix`	Commit message prefix for sync operations (system adds smart version suffix)	`"chore: sync version to "`
`reactNativeVersionBumper.expo.syncNativeFiles`	Sync Expo version changes to native Android and iOS files	`false`
`reactNativeVersionBumper.git.skipBranch`	Skip branch creation	`false`
`reactNativeVersionBumper.git.autoCreateBranch`	Auto-create branch	`false`
`reactNativeVersionBumper.git.branchNameTemplate`	Branch name template	`"release/{version}"`
`reactNativeVersionBumper.git.skipTag`	Skip tag creation	`false`
`reactNativeVersionBumper.git.autoCreateTag`	Auto-create tag	`false`
`reactNativeVersionBumper.git.tagNameTemplate`	Tag name template	`"v{version}"`
`reactNativeVersionBumper.git.skipPush`	Skip pushing to remote	`false`
`reactNativeVersionBumper.enableCodeLens`	Enable or disable CodeLens for version bumping	`true`
`reactNativeVersionBumper.showInStatusBar`	Show version information in the status bar	`true`
`reactNativeVersionBumper.batchMode`	Preview all operations before execution - shows file modifications, version changes, and Git operations in an interactive preview before applying (recommended)	`true`

Commit Message Configuration

Configure commit message prefixes for different operations:

Settings:

git.commitMessagePrefix: For regular version bumps (default: "chore: bump version to ")
git.syncCommitMessagePrefix: For sync operations (default: "chore: sync version to ")

How it works:

You configure the prefix, the system adds the version suffix
Messages are project-aware and contextual

Examples:

Project Type	Bump Result	Sync Result
Expo Projects	`chore: bump version to v1.2.0`	`chore: sync version to v1.2.0`
React Native (Same Versions)	`chore: bump version to v1.2.0`	`chore: sync version to v1.2.0`
React Native (Different Versions)	`chore: bump version to Android v1.2.0, iOS v1.2.1`	`chore: sync version to v1.2.0`
Package.json Only	`chore: bump version to package.json v1.2.0`	`chore: sync version to package.json v1.2.0`

Branch & Tag Templates

Configure branch names and tag names using template placeholders:

Settings:

git.branchNameTemplate: Branch name format (default: "release/{version}")
git.tagNameTemplate: Tag name format (default: "v{version}")

Available placeholders:

{type}: Bump type (patch, minor, major)
{version}: Latest version (from Git tag or package.json)
{date}: Current date (YYYY-MM-DD format)
{androidVersion}: Android version number
{iosVersion}: iOS version number
{androidBuildNumber}: Android build number
{iosBuildNumber}: iOS build number

Examples:

"release/{version}" → release/1.2.0
"v{version}" → v1.2.0
"release/{type}-{date}" → release/patch-2024-01-15

Release Notes

The extension automatically generates release notes with the following behavior:

1. Uses existing project templates (if found):

.github/RELEASE_TEMPLATE.md
.github/release_template.md
.github/RELEASE_NOTES_TEMPLATE.md
.gitlab/RELEASE_TEMPLATE.md
Similar variations

2. Appends version information at the end (only if not already present):

**Version Updates:**

- Android: 1.0.0 → 1.0.1 (build 123)
- iOS: 1.0.0 → 1.0.1 (build 456)

**Full Changelog**: https://github.com/user/repo/compare/v1.0.0...v1.0.1

3. Falls back to simple default if no template exists:

**What's Changed:**

<!-- Add your changes here -->

-
- **Version Updates:**

- Android: 1.0.0 → 1.0.1 (build 123)
- iOS: 1.0.0 → 1.0.1 (build 456)

**Full Changelog**: https://github.com/user/repo/compare/v1.0.0...v1.0.1

To customize release notes: Create a .github/RELEASE_TEMPLATE.md file in your project with your preferred format. The extension will automatically use it and append version information at the end.

❓ FAQ

Q: Why not a CLI tool instead of a VS Code extension?
A: CLI alternatives exist: Fastlane and EAS excel at CI/CD automation, while react-native-version and bash scripts are used for development workflows but require remembering commands, switching contexts, and lack visual feedback and interactive previews.

This extension solves those problems by bringing version management directly into your editor for active development:

Interactive previews: See file changes and Git operations before applying
Visual CodeLens: Click ↑ arrows directly above version lines
Built-in Git workflow: Branch creation, commits, tags, and releases
Zero context switching: Everything within your coding environment

Q: How do I create a release or merge request?
A: Use the "Bump All + Git" command. After a successful bump, the webview shows buttons to:

Create a release for the new tag (e.g., on GitHub or GitLab).
Create a merge request for the new branch (e.g., on GitHub or GitLab). These open in your browser for the configured Git remote.

Q: How do I toggle CodeLens?
A: Click the editor title bar button when editing package.json, build.gradle, Info.plist, or Expo config files (app.json, app.config.js/ts). The button shows a circle with an upward arrow (enabled) or a slashed version (disabled), toggling CodeLens instantly.

Q: What if my project structure is different?
A: Customize file paths in the settings (e.g., android.buildGradlePath, ios.infoPlistPath, ios.projectPbxprojPath). The extension auto-detects Info.plist and project.pbxproj for iOS if not specified, so it works with non-standard React Native project structures.

Important: Custom iOS paths are fully supported - if you configure ios.infoPlistPath to point to a custom location (e.g., custom/Info.plist), all version operations including CodeLens will respect this custom path.

Q: Can I use this with monorepos?
A: Yes! You can skip package.json updates and focus on platform-specific files, or configure custom paths for monorepo structures.

Q: What about EAS auto-increment for Expo projects?
A: When EAS auto-increment is configured in your eas.json and you're bumping Expo versions, the extension shows a warning before the preview to make you aware that EAS will handle build number increments automatically. This prevents conflicts between manual version bumping and EAS automation.

Q: What's the difference between the "Skip" option and the skipPackageJson setting?
A: The "Skip" option appears during the interactive bump process and lets you skip package.json for that specific operation. The skipPackageJson setting permanently disables package.json updates. Use "Skip" for occasional exclusions, use the setting for permanent workflow preferences.

🛠️ Development Setup

Tools: Bun, VS Code, TypeScript.
Build: bun run compile
Test: bun run test
Package: bun run package (creates .vsix)
Publish: bun run publish (for maintainers)

🙌 Contributing

Contributions are welcome! Please see Contributing Guidelines for details.

📜 License

This project is licensed under the MIT License.

Made with ❤️ for the React Native & Expo community
@sandipshiwakoti

React Native Version Bumper

Sandip Shiwakoti

React Native Version Bumper

✨ Features

🚀 Installation

⚡ Quick Start

🎥 See It In Action

⚡ CodeLens: One-Click Version Updates

🔄 Bump All Platforms

⚒️ Complete Git Workflow

🔀 Sync All Platforms

📊 Version Overview

🚀 Expo Support

📋 Usage

1. Open Your Project

2. Run Commands

3. CodeLens (Click ↑ to Bump)

4. Auto-Detection & What Gets Updated

5. Status Bar

⚙️ Configuration

Commit Message Configuration

Branch & Tag Templates

Release Notes

❓ FAQ

🛠️ Development Setup

🙌 Contributing

📜 License