Docs changelog

This page tracks documentation updates: new guides, updated procedures, and changes reflecting new or updated Bitrise features.

Subscribe to RSS

2026 September

2026-09-30 Bitrise CLI adds build trigger flags

You can now set the stack, machine type, and license pool when you run bitrise build trigger, and pass --env values without variable expansion. The --priority flag now overrides the configured priority even when it's 0. See Managing builds with the Bitrise CLI.

2026-09-30 Bazel Build Cache installs CLI to local bin

The Bazel Build Cache setup guides now install the Bitrise Build Cache CLI into $HOME/.local/bin and add it to PATH, so Bazel finds the credential helper by name from any repository. See Configuring the Build Cache for Bazel in GitHub Actions.

2026-09-30 CodePush supports binary diffing delta updates

You can now opt in to binary diffing for CodePush delta updates with Bitrise CodePush SDK 10.6.0 or newer, and the guide explains how Bitrise generates deltas between updates. See Delta updates.

2026-09-30 MCP server returns structured output

Every Bitrise MCP server tool now advertises an output schema and returns its result as structured content alongside the text. See Tools.

2026-09-29 Non-Bitrise CI Build Cache uses workspace tokens

The Build Cache setup guides for Gradle, Bazel, Xcode, and React Native on other CI providers now recommend a workspace API token instead of a personal access token. See Getting started with the Build Cache.

2026-09-29 New guides for the Bitrise CLI

The Bitrise CLI section now covers logging in, configuring the CLI, managing builds, and working with bitrise.yml from the command line. See Authenticating with the Bitrise CLI.

2026-09-29 Create fully configured projects from the CLI

The project creation guide now follows the redesigned page, where you copy a command that creates a fully configured project in your current workspace. With Bitrise CLI v3, you can also create just the project skeleton with bitrise app create. See Adding a new project from a CLI.

2026-09-25 Warm pools for Remote Dev Environments

You can now keep pre-booted Remote Dev Environment sessions ready in a warm pool, so new sessions and device preview links open in seconds. Create pools in the UI, the CLI, with an AI agent, or through the API. See Warm pools.

2026-09-25 Per-project Build Cache scoping

You can now limit the Build Cache on a machine to the projects you opt in, instead of caching every project. See Per-project cache scoping.

2026-09-25 CodePush CLI documents source map options

The CodePush CLI guide now explains where the CLI writes source maps by default and how to set a custom location with --sourcemap-output. See Using the CodePush CLI.

2026-09-23 Preview link sessions are workspace-owned

Sessions opened from a device preview link now always belong to the workspace, whichever credential created the link. You find them under Workspace sessions, not in your personal session list. See Device preview links.

2026-09-22 Build Hub runners need no Build Cache token

On Bitrise Build Hub runners, the Build Cache CLI authenticates itself because the machine is already connected to your workspace. This needs Bitrise Build Cache CLI v3.10.0 or newer. See Getting started with the Build Cache.

2026-09-22 MCP server expands tester group tools

The Bitrise MCP server tools can now create tester groups and CodePush deployments together with an app, add workspace members as internal testers, and list potential testers before a group exists. See Tools.

2026-09-22 Pin builds to the latest Stable stack

You can now use the osx-xcode-latest-stable and ubuntu-latest-stable stack IDs so your builds always run on the current Stable stack. See Setting the stack for your builds.

2026-09-21 Update CI docs with CLI v3 syntax

CI documentation now shows CLI v3 command syntax, where commands like bitrise run are documented as bitrise local run. Existing commands keep working as before. See Running your first local build with the CLI.

2026-09-18 Remote Dev Environments adds virtual devices

You can now use an iOS simulator or Android emulator on Remote Dev Environments, either through an interactive device session or a shareable device preview link. See Virtual devices.

2026-09-18 Fixed who can toggle pull request build approval

The docs now correctly say that Edit workflows (not Approve build requests) controls who can turn the manual pull-request-approval setting on or off. Approve build requests only covers approving or declining individual builds once that setting is on. See Approving pull request builds.

2026-09-18 GitHub Actions setup guides for the Build Cache

Each Build Cache tool (Gradle, Xcode, Bazel, React Native) now has a dedicated GitHub Actions setup guide, with runnable workflow YAML for both Build Hub runners and GitHub-hosted runners. See Configuring the Build Cache for Gradle in GitHub Actions.

2026-09-17 Local Build Cache builds now push by default

Activating the Build Cache locally for Gradle, Bazel, and React Native now pushes to the cache by default, matching CI behavior. Pull-only mode is still available as an opt-in. See Configuring the Build Cache for Gradle in local builds.

2026-09-17 Custom roles docs for Enterprise workspaces

Enterprise workspaces can now create custom roles with specific permission sets, and the docs cover creating and editing roles, the full permissions reference, and an FAQ. See Custom roles overview.

2026-09-17 Clarified runs-on label matching for Build Hub GitHub Actions pools

The docs now spell out that a machine pool must have every label listed in a job's runs-on array, not just one of them, with a worked example. See Configuring your GitHub Actions workflow.

2026-09-15 MCP server adds Insights tools

The Bitrise MCP server now exposes build and test metrics from Bitrise Insights as tools, covering totals, time series, and flaky test tracking. Requires a paid Insights plan. See Bitrise MCP tools.

2026-09-15 Getting started with AI for the Build Cache

A new page gives you a ready-to-use AI prompt for setting up the Build Cache with a coding agent like Claude Code. See Getting started with AI.

2026-09-10 Remote Dev Environments is generally available

Remote Dev Environments has left beta. The beta notice has been removed from the RDE documentation, and the overview now points to self-serve sign-up alongside the sales route. The RDE API is still marked experimental: endpoints and payloads can change in backwards-incompatible ways. See Remote Dev Environments overview.

2026-09-01 Track Remote Dev Environments usage across API, CLI, MCP, and UI

You can now check RDE workspace usage through the REST API, the rde usage CLI command, the MCP server, or the UI. See Remote Dev Environments API.

2026 August

2026-08-31 CodePush delta updates

Learn what delta updates are, why they matter, and which version Bitrise currently supports. See Delta updates.

2026-08-26 Enable Build Cache writes for React Native on non-Bitrise CI

Docs now show how to pass --cache-push so a non-Bitrise CI provider can write to the Build Cache, not just read from it. See Configuring the Build Cache for React Native in non-Bitrise CI environments.

2026-08-25 GitHub stacked pull requests

Trigger conditions and $BITRISEIO_GIT_BRANCH_DEST now explain how Bitrise handles GitHub stacked pull requests, matching against the stack's base branch. See About build triggers.

2026-08-24 Remote Dev Environments FAQ, and a corrected session retention model

New Remote Dev Environments FAQ answers the most common questions about sessions, storage, connecting, credentials, AI coding agents, and limits.

The session retention documentation was also corrected. Terminated sessions are not cleaned up after a fixed period: a session's persistent disk is kept until you delete it, or until the stack it was created from is removed under the stack deprecation and removal policy. Key concepts now also explains that a session stays permanently tied to the stack it was created from and can't be moved to a different one.

2026-08-14 Manage Remote Dev Environments access from Collaboration

RDE is now a standalone product in workspace collaboration: grant or revoke the RDE User role for members and groups from the Collaboration page, or assign it through SCIM with rde:rde_admin. See Managing RDE access.

2026-08-06 Utility builds beta for Pro plans

Short Linux builds that run on the Linux Small machine type don't count against your build quota during the beta. See Utility builds.

2026-08-05 Edit modular YAML in the Workflow Editor

The Workflow Editor now loads every module of a configuration split with the include keyword, shows the merged result, and pushes your changes back to your repository in one step. See Editing a modular configuration in the Workflow Editor.

2026 July

2026-07-30 Linux tooling steps scoped to the Docker-based image

The tooling-access steps for Build Hub Linux machines apply only to the deprecated Docker-based image. If you use linux-bitvirt-2026, you can skip them. See Configuring your GitHub Actions workflow.

2026-07-30 Select Bazel RBE worker pools by name

Remote Build Execution for Bazel now routes builds with a single Pool=<pool-name> execution property, instead of separate architecture and OS properties.

2026-07-30 CodePush SDK setup steps rewritten

The React Native and Expo setup guides now match the current CodePush SDK, with the Expo instructions first. See Configuring your mobile app for CodePush.

2026-07-24 Bitrise CI API reference corrections

The API documentation now covers the pipeline outgoing-webhook event type, the full set of app role groups, optional Android keystore parameters, and the correct build notification defaults.

2026-07-24 Configuration YAML reference gains missing limits

The reference now documents the status_report_name and parallel limits, trigger priority, and the values should_always_run actually accepts.

2026-07-24 Workspace invitations can be rate-limited

Invitations sent from Workspaces on non-paid plans may be rate-limited. See Workspace collaboration.

2026-07-20 Developing a new step guide rewritten

The walkthrough for building your own Step has been rewritten, with inaccurate statements corrected and background material trimmed.

2026-07-14 RDE CLI docs refreshed to match current commands

The RDE CLI reference now covers stack-based session creation, running commands in a session with session exec, VNC tunneling, workspace selection, and the reconnect behavior of rde claude. See Bitrise RDE CLI.

2026-07-10 Building a Slack-native coding agent

A new recipe walks through a reference architecture for a Slack-native coding agent: a locked-down orchestrator that delegates coding work to disposable Remote Dev Environments, plus an open source reference implementation you can try. See Building a Slack-native coding agent.

2026-07-09 Bitrise Desktop App for macOS

A new guide covers the Bitrise Desktop App for macOS: installing it, signing in, selecting a workspace and project, configuring filters and notifications, and troubleshooting. See Bitrise Desktop App for macOS.

2026-07-07 Product subscriptions can now be canceled independently

Each product (Bitrise CI, Build Cache, Release Management, and so on) has its own independently cancellable subscription, and add-ons can be canceled on their own too. The docs now walk through the updated Plan & Billing cancellation flow. See Workspace billing and invoicing.

2026-07-02 Bitrise MCP server drops self-registration tools

The register and verify_registration tools, along with the registration API group, are no longer part of the Bitrise MCP server. See Bitrise MCP tools.

2026 June

2026-06-29 RDE API reference now available in-site

The Remote Dev Environments REST API reference is now part of docs.bitrise.io as a native interactive explorer, covering 42 endpoints across user, workspace, sessions, templates, and saved inputs. See RDE API reference.

2026-06-29 Remote Dev Environments docs now available

Documentation for Bitrise Remote Dev Environments (RDE) is now available, covering key concepts, a quickstart, configuration options (templates, saved inputs), and the available interfaces: CLI, MCP server, UI, and VS Code plugin. See Remote Dev Environments.

2026-06-26 Agent onboarding guide updated with OAuth flow

The onboarding guide for AI agents now covers the full OAuth sign-in flow in detail: how your agent triggers browser authorization, creating an account during sign-in, email confirmation for password-based accounts, and troubleshooting steps for common issues.

2026-06-23 Entra ID SCIM provisioning guide

You can now set up automatic user and group provisioning for your Bitrise workspace using Microsoft Entra ID SCIM. The guide covers generating SCIM credentials, configuring Entra ID, attribute mapping, group and deprovisioning behavior, and migrating existing workspace members. See Entra ID SCIM.

2026-06-22 Bitrise CI API reference is now interactive

The Bitrise CI API reference is now available as a full interactive explorer at /en/bitrise-api, replacing the previous SwaggerUI embed. Endpoints are grouped by tag with a sidebar, and you can try requests directly from the docs. See Bitrise CI API reference.

2026-06-19 CodePush CLI docs expanded with full reference

The CodePush CLI documentation has been expanded and restructured. A new reference page covers all commands, global flags, environment variables, and exit codes. The Using the CodePush CLI page now includes workflow examples, JSON output, and Bitrise CI integration details. The code signing page adds a directory naming warning and a React Native >= 0.61 Android setup note. See CodePush CLI.

2026-06-18 AI agent onboarding tip added to sign-up page

The Signing up for Bitrise page now includes a tip pointing AI agents to the dedicated onboarding runbook, which covers how to create a Bitrise account and connect everything directly from an agent session without a website visit.

2026-06-17 GitHub App integration: event subscriptions clarified

The GitHub App integration page now has an Event subscriptions section explaining that the Bitrise GitHub App subscribes to push, pull_request, and issue_comment events via GitHub's app installation mechanism, not through repo-level webhooks. The section also warns that any existing manual webhooks pointing to hooks.bitrise.io must be removed after switching to the GitHub App to avoid duplicate builds.

2026-06-15 Bitrise MCP: new registration tools and API group

The Bitrise MCP server now includes a registration API group with two unauthenticated tools — register and verify_registration — that let an AI agent onboard a brand-new Bitrise user without a token. The agent sends a one-time password to the user's email via register, then calls verify_registration with the OTP to receive a personal access token. These tools are most useful with the remote (HTTP) MCP server. See Bitrise MCP tools for the full reference.

2026-06-15 Bitrise MCP: install guides added for six tools

Step-by-step install guides for the Bitrise MCP server are now available for VS Code, Cursor, Claude, Windsurf, Kiro, Gemini CLI, and other Copilot-compatible IDEs. Each guide covers how to configure the MCP server and authenticate with your Bitrise token. See Bitrise MCP to get started.

2026-06-11 Workflow Editor can now push bitrise.yml directly to the repository

The Workflow Editor now supports pushing changes to a repository-stored bitrise.yml directly from the editor — either to the current branch or a new branch — without manually copying and committing. See Storing an app's configuration YAML for the updated flow.

2026-06-10 Build Hub: Gradle dependency mirroring explained

The Build Hub documentation now includes an explanation of how Gradle dependency mirroring works, giving you a clearer picture of caching behaviour for Gradle projects running on Build Hub.

2026-06-09 Configuration YAML docs updated for YAML/Visual mode switcher

References throughout the docs have been updated to reflect the new toggle between YAML and Visual editing modes in the Workflow Editor. Where instructions previously referred to the left navigation menu, they now point to the YAML toggle at the top of the editor.

2026-06-08 New guide: Maven Central repository manager

A new guide covering the Maven Central repository manager is now available under Build Cache getting started. It explains how Bitrise's proxy cache works for Maven dependencies, covers special cases like dependency verification and custom Docker images, and documents the opt-out process.

2026-06-08 Bitrise MCP server: OAuth is now the primary authentication method

The Bitrise MCP server now uses OAuth as the primary authentication method. See Bitrise MCP for the updated setup steps.

2026 May

2026-05-29 Build distribution: custom access links for installable artifacts

In Release Management, you can now create shareable install links. See Custom access links for details.

2026-05-28 Modular YAML: increased file and nesting limits for GitHub users

The modular YAML configuration guide has been updated to reflect the new, higher file count and nesting limits for GitHub users. See Modular YAML configuration for the updated limits.

2026-05-20 Python projects now supported

Bitrise now detects Python projects automatically and offers default workflows. The Default workflows and Getting started with Bitrise CI guides have been updated to include Python.

2026 April

2026-04-20 Next.js and Flutter Web project types documented

The Getting started with Bitrise CI guide and Default workflows page now cover Next.js (as an extension of Node.js) and Flutter Web project types.

2026 March

2026-03-30 M4 machine type added to build machine docs

The Build machine types page now lists the M4 machine type alongside the existing M4 Pro, M2 Pro, and M1 options, with region availability for each.

2026-03-25 Ruby projects now supported

Bitrise now detects Ruby projects automatically and offers default workflows. The Getting started with Bitrise CI guide has been updated to include Ruby.

2026-03-24 Pro Trial: credit card required to access the full trial

New users now need to provide a valid credit card (which won't be charged) to access the full Pro Trial. The Getting started with Bitrise CI guide has been updated to explain this.

2026-03-20 New page: build artifact retention policy

A dedicated Build artifact retention policy page is now available, covering default retention periods by artifact type, extended retention options for enterprise customers, and the edge case around transferred projects.

2026-03-10 Xcode compilation cache: new flag to disable caching without disabling analytics

The Xcode compilation cache FAQ now documents the --no-bitrise-build-cache flag, which lets you disable caching temporarily while keeping analytics and build history intact.

2026 February

2026-02-20 Build Cache: clear cache button replaces Settings dropdown

The Clearing the Build Cache guide has been updated to reflect the current UI: the Settings dropdown was replaced by a Clear Cache button. The guide includes a new screenshot and a note that clearing the cache requires Workspace owner permissions.

2026-02-20 New guide: Endpoint Detection and Response (EDR) on Bitrise

A new page under Integrations explains how Bitrise uses Endpoint Detection and Response (EDR) as part of its corporate security program, and clarifies that EDR agents are not deployed on Bitrise-hosted CI runners.

2026-02-13 OIDC for AWS guide updated

The OIDC for AWS guide has been updated with additional clarifications on configuration and usage.

2026-02-03 New guide: GitHub App migration API

A new guide explains how to use the Bitrise API to bulk-migrate projects from OAuth-based GitHub connections to the GitHub App integration, including caveats about reverting the migration. See Adding and managing apps for details.

2026 January

2026-01-27 Tool setup: new tool versions added

The Configuring tool versions guide has been updated with newly supported tool versions in the tool setup feature.

2026-01-19 Build artifact retention policy documented

The Build artifacts page now includes a section on the artifact retention policy, covering default retention periods by artifact type and options for Enterprise customers. The policy takes effect on March 31, 2026.

2026-01-12 Pipeline rebuild: dynamic parallel workflows explained

The guide on rebuilding failed pipelines now includes an explanation of how dynamic parallel Workflows affect rebuild options — specifically, when you can rebuild individual Workflows versus all unsuccessful ones. See Rebuilding a failed build for details.

<head> <meta name="robots" content="noindex, follow" /> </head>