sorenbcoding/workflow-viewer-for-bitbucket

The app is a Forge app. You deploy it into your own Bitbucket workspace; it does not need to be on the Atlassian Marketplace.

Requirements: Node.js 22 or later, and an Atlassian account with admin rights on the Bitbucket workspace.

npm install -g @forge/cli
forge login                       # once, with an Atlassian API token

git clone https://github.com/sorenbcoding/workflow-viewer-for-bitbucket.git
cd workflow-viewer-for-bitbucket
npm install

cd apps/forge-app
forge register                    # once, writes your app id into manifest.yml
npm run deploy                    # builds the UI and runs forge deploy
forge install --product bitbucket # pick your workspace

After installing, the app appears in two places:

• Workflow Viewer: open a .xaml file in the repository's Source view. Use the dropdown at the right end of the file header, the bar above the code that shows the file path, and choose Workflow Viewer. It is not in the Source / Diff / History dropdown at the top of the page.
• Workflow overview: in the repository's left menu, expand Apps near the bottom. The page is listed under Workflow Viewer for Bitbucket. A development install shows (default) after the names.

To roll out a new version, run npm run deploy again; installed workspaces update automatically. For production, use forge deploy -e production and forge install -e production. To install in other workspaces without a Marketplace listing, use the install link under Distribution in the Developer console.

Local development

npm install
npm run dev      # dev harness at http://localhost:5173 with the samples in samples/
npm test         # parser tests
npm run typecheck

The dev harness can also open a local project folder or a single .xaml file. Files are read in the browser and never uploaded.