Skip to content
Bitrise Workflow Editor
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
_scripts Release automation (#47) Feb 7, 2017
apiserver Dep update, test fix, version update (#362) Feb 15, 2019
cmd print bitrise.yml path (#184) Aug 7, 2017
data Always allow to expose secrets & code signing files for PRs (#369) Apr 16, 2019
discuss_topic Skip version bump commit from changelogs (#324) Sep 5, 2018
github_release Fix syntax error in GitHub changelor create (#331) Sep 14, 2018
source Remove fastlane project type (#368) Apr 25, 2019
spec/javascripts Only use namespaced metadata (#262) Feb 26, 2018
vendor Remove fastlane project type (#368) Apr 25, 2019
version v1.1.53 Apr 16, 2019
.gitignore version command and prepare for release (#30) Jan 30, 2017 v1.1.53 Apr 16, 2019
Dockerfile v1.1.27 Aug 23, 2018
Gemfile Remove AngularJS rails gem, and update AngularJS to version 1.7.2 (#306) Jul 25, 2018
Gemfile.lock Update rubyzip gem (#340) Oct 15, 2018
Gopkg.lock Dep update, test fix, version update (#362) Feb 15, 2019
Gopkg.toml Dep update (#204) Oct 10, 2017
LICENSE Initial commit Sep 1, 2016 Extend the version release process in the readme (#342) Oct 16, 2018
Rakefile first beta release (#29) Jan 30, 2017
bitrise-plugin.yml v1.1.53 Apr 16, 2019
bitrise.yml v1.1.53 Apr 16, 2019
config.rb Stacks tab added (#235) Jan 25, 2018
docker-compose.yml docker configuration updated - fix port for development mode May 22, 2017
main.go Cobra cli (#34) Jan 31, 2017
release_config.yml Use commit messages for release notes (#307) Jul 25, 2018

Bitrise Workflow Editor

How to install & use the Workflow Editor on your Mac/Linux

  1. Install Go brew install go(on macOS)
  2. Install the latest Bitrise CLI - it's a single binary command line tool
  3. Run bitrise setup just to be sure everything's prepared
  4. cd into a directory where you have your bitrise.yml, and run: bitrise :workflow-editor

That's all. The Workflow Editor is now part of the Bitrise CLI core plugins, so you don't have to install it manually.

To upgrade to the latest version of the Workflow Editor run:

bitrise plugin update workflow-editor

Join the Workflow Editor's discussion at:


Build a stand-alone binary, with embedded resources

bitrise run go-install

Run in development mode

  1. In the Workflow Editor's directory, run docker-compose up.
  2. In your browser, you can reach the Workflow Editor on localhost:1234. Be aware that you usually have to wait a while.
  3. By default, the Workflow Editor will open the bitrise.yml and .bitrise.secrets.yml found in this folder. For testing purposes, you probably want to be able to edit custom files. This can be achieved by setting the TEST_BITRISE_CONFIG_PATH and TEST_BITRISE_SECRETS_PATH environment variables with the path pointing to the custom files' paths.

Run tests

  1. In the Workflow Editor's directory, run up-middleman-jasmine.
  2. In your browser, you can reach the tests on localhost:4567/jasmine.
  3. Every time you make a change to the code, you have to exit the running workflow and start it up again. You can make changes to the specs without having to do this.

New version release

  • Generate a GitHub personal access token for your user (one who has rights to create releases on the repository) - you can generate one here:
  • Generate a Discuss API key: you need to be a Discourse admin for this, then you can generate an API key for yourself at:
  • Ensure clean git
  • If new release requires Bitrise CLI to be updated, in bitrise-plugin.yml change min_version requirement of the bitrise tool to the required CLI version
  • Call bitrise run create-release
  • During the build you will need to specify a new version number, and if you did not specify any of the secrets above, you will need to specify those as well.
  • After the build has finished, close the related GitHub issues, and milestones if the issues were assigned to any.

Testing if version release works, without actually releasing

  • In bitrise.yml, create a workflow e. g. test-release
  • From the create-release workflow, copy-paste the GitHub release and Create Discuss topic steps.
  • In the GitHub release step, remove the files_to_upload input, set the $NEW_RELEASE_VERSION everywhere to something arbitrary, same for the body, and most importantly set draft: 'yes'
  • In the Create Discuss topic step, change the DISCUSS_CHANGELOG_CATEGORY_ID to the ID of one our's internal channels' ID (you can find an ID using the Discourse API with a cURL request) so that it is only visible to us; also change the title and the raw parameter to something arbitrary.
  • After the test release process, don't forget to delete the draft release and the internal changelog topic.
You can’t perform that action at this time.