GitHub Actions Workflow Diagram

Overview

This document describes all GitHub Actions workflows and their relationships.

---

Workflow Diagram

---

Trigger Summary

Trigger Type	Workflows
push: main	Main Validations, Sync — HP
pull_request	PR workflows, Clean Deployment (on close)
schedule (cron)	Staging Validations (9 AM & 3 PM EST)
workflow_call (reusable)	release.yml, electron-release.yml, main-sync-to-staging.yml
workflow_dispatch (manual)	All workflows support manual trigger

---

---

Key Flow: Main → Staging Sync

Developer pushes to main
         │
         ▼
┌─────────────────────┐
│ main-build-&-deploy │
│     triggers        │
└──────────┬──────────┘
           │
           ▼
    ┌──────────────┐
    │  validations │
    └──────┬───────┘
           │
           ▼
    ┌──────────────┐
    │   release    │ ──► Creates version commit (e.g., v1.17.0)
    └──────┬───────┘
           │
           ▼
    ┌──────────────────┐
    │ electron-release │ ──► Creates electron version commit [skip ci]
    └──────────┬───────┘
               │
               ▼
    ┌──────────────────────┐
    │   sync-to-staging    │ ──► Merges ALL commits (including versions) to staging
    │                      │
    │ Runs if release      │
    │ succeeded, regardless│
    │ of electron-release  │
    └──────────────────────┘
               │
               ▼
        staging branch
        now has all
        version commits

---

File Reference

Workflow File	Display Name
main-build-&-deploy.yml	Main Validations
staging-build-&-deploy.yml	Staging Validations
main-sync-to-staging.yml	Sync — staging
hp-sync.yml	Sync — HP
pr-hpchannels.yml	PR workflows
cleanup.yml	Clean Deployment
release.yml	Release HP Web Version
electron-release.yml	Release HP Electron Version
figma_to_styles.yml	Sync Figma variables to tokens
Build-&-Deploy-HP-Channels-doc.yml	HP-Channels-doc: Build & Deploy
Build-&-Deploy-HP-Channels-prod.yml	HP-Channels-prod: Build & Deploy
Build-&-Deploy-HP-Channels-storybook.yml	HP-Channels-storybook: Build & Deploy