Skip to main content

GitHub Actions Workflows

This page provides an overview of the GitHub Actions workflows used in this repository. These workflows automate various parts of our CI/CD process, from code quality checks to automated testing and deployments.

Documentation

Building and deploying documentation

E2E

End-to-end testing on iOS and Android

Security

Security scanning and vulnerability detection

TestRail

Test case and result syncing with TestRail

[Admin] Add pull request to project board​

(add-pr-to-project.yml)

Automatically adds non-draft PRs targeting the develop branch to the GitHub project board. Triggers when PRs are opened, reopened, synchronized, or marked as ready for review.

SourceRuns
Triggers:
  • Pull Request
    • When: Opened, Reopened, Synchronize, Ready For Review
↑ Back to Top

[Admin] Auto-Link Milestone to PR​

(apply-milestone.yml)

Automatically links the nearest upcoming milestone to a PR's linked issue (or the PR itself) when a PR touching app source code is merged. Ensures all merged work is tracked under the correct release milestone.

SourceRuns
Triggers:
  • Pull Request
    • When: Closed
    • File Paths:
      • VAMobile/src/**
↑ Back to Top

[Admin] Check for linked issues in PRs​

(check-linked-issues.yml)

Checks that every PR has a linked issue. If no linked issue is found, it posts a comment asking the author to link one. PRs targeting release, dependabot, and main branches are excluded from this requirement.

SourceRuns
Triggers:
  • Pull Request
    • When: Opened, Edited, Reopened, Synchronize, Labeled, Unlabeled
↑ Back to Top

[Admin] Check if PR is from an experience team​

(team-check-alert.yml)

Checks whether a PR author is a member of the flagship-mobile-team. If the author is not a team member (i.e., from an experience team), sends a Slack notification to va-mobile-app alerting designated contacts.

SourceRuns
Triggers:
  • Pull Request
    • Branches: develop
    • When: Opened
Uses:
↑ Back to Top

[Admin] Flagship Mobile Alerts Weekly On-Call Assignment​

(rotate-flagship-oncall.yml)

Posts the weekly on-call assignment to the va-mobile-app-alerts Slack channel every Monday. Fetches the current on-call person from PagerDuty, sends a Slack notification, and updates the channel topic.

SourceRuns
Triggers:
  • Manual Trigger (workflow_dispatch)
  • Schedule
    • Cron: 30 13 * * 1 (At 01:30 PM, only on Monday UTC)
↑ Back to Top

[Admin] Issue Created Notifications​

(issue_created.yml)

This workflow triggers when a new issue is opened and routes notifications to Slack based on issue labels (e.g., user-onboarding, devops, go-live, project-kickoff).

SourceRuns
Triggers:
  • Issue
    • When: Opened
Uses:
↑ Back to Top

[Admin] Notify Slack of DevOps issues​

(automation-issue-notification.yml)

When a new issue with the 'devops' label is opened, adds it to the DevOps project board with "Ready to Work" status and sends a Slack notification to the va-mobile-devops channel.

SourceRuns
Triggers:
Uses:
↑ Back to Top

[Admin] Notify Slack of new Onboarding requests​

(user-onboarding-issue-notification.yml)

Sends a Slack notification when a new issue with the 'user-onboarding' label is opened. Looks up Slack IDs for the designated onboarding contacts and posts a message with a link to the issue.

SourceRuns
Triggers:
Uses:
↑ Back to Top

[Admin] Onboarding Issue Handler​

(onboarding.yml)

Placeholder onboarding workflow that triggers when an issue is labeled with 'onboarding'. Currently logs the issue event; Slack notification logic is commented out pending future implementation.

SourceRuns
Triggers:
  • Issue
    • When: Labeled
Uses:
↑ Back to Top

[Admin] Prune Stale Branches​

(prune-stale-branches.yml)

Deletes remote branches whose last commit is older than 365 days and that have no open PRs. Runs weekly on a schedule (dry-run by default) or manually, creates a CSV artifact of affected branches to the pipeline run that can be retrieved, and notifies Slack with a summary.

SourceRuns
Triggers:
  • Schedule
    • Cron: 0 2 * * 0 (At 02:00 AM, only on Sunday UTC)
  • Manual Trigger (workflow_dispatch)
    Inputs:
    InputDescriptionTypeDefaultRequired
    dry_runDry run (list branches without deleting)booleantrueNo
    Uses:
    ↑ Back to Top

    [Admin] QA Required Approvals​

    (qa_required_approvals.yml)

    Enforces that PRs modifying app source code have at least one engineer approval and one QA team approval before merging. Checks changed files against inclusion/exclusion patterns and validates review approvals.

    SourceRuns
    Triggers:
    • Pull Request
      ↑ Back to Top

      [Admin] Team Membership Alert​

      (team-membership-alert.yml)

      Monitors the flagship-mobile-team GitHub team for new members. Runs daily, compares current members against a stored list, and notifies Slack when new members are detected. Updates the stored member list accordingly.

      SourceRuns
      Triggers:
      • Schedule
        • Cron: 0 14 * * * (At 02:00 PM UTC)
      • Manual Trigger (workflow_dispatch)
      Uses:
      ↑ Back to Top

      [Admin] Weekly Flagship Mobile PR Reviewer Assignment​

      (rotate-flagship-pr-reviewer.yml)

      Rotates the primary PR reviewer assignment biweekly on Mondays. Updates Slack channel topics for va-mobile-app and va-mobile-app-engineering with the current reviewer and backup, and posts a notification message.

      SourceRuns
      Triggers:
      • Schedule
        • Cron: 33 13 * * 1 (At 01:33 PM, only on Monday UTC)
      ↑ Back to Top

      [Build] Daily QA Build​

      (qa_build.yml)

      Runs daily QA builds for iOS and Android on weekday mornings. Queues the build, notifies Slack, and triggers the reusable build_ios and build_android workflows with default QA settings.

      SourceRuns
      Triggers:
      • Schedule
        • Cron: 0 4 * * 1,2,3,4,5 (At 04:00 AM, only on Monday, Tuesday, Wednesday, Thursday, and Friday UTC)
      Uses:
      ↑ Back to Top

      [Build] On Demand Build​

      (on_demand_build.yml)

      Manually triggered on-demand builds for iOS and Android. Accepts environment (staging/production) and notes as inputs, queues the build, notifies Slack, and runs both platform builds from the triggering branch.

      SourceRuns
      Triggers:
      • Manual Trigger (workflow_dispatch)
        Inputs:
        InputDescriptionTypeDefaultRequired
        environmentEnvironmentchoicestagingYes
        notesNotesstring-Yes
        Uses:
        ↑ Back to Top

        [Build] Queue Build​

        (queue_builds.yml)

        Reusable workflow that queues builds by waiting for any older in-progress build workflows (QA, On Demand, Release, RC) to finish before allowing the current build to proceed. Prevents concurrent build conflicts.

        SourceRuns
        Triggers:
        ↑ Back to Top

        [Build] Release Build​

        (release_build.yml)

        Builds production release builds for iOS and Android, triggered by a v*.*.* tag (created by run_approval.yml when a release is approved). Queues the build, notifies Slack, runs both platform builds, and alerts on failure.

        SourceRuns
        Triggers:
        • Push
          • Tags: v[0-9]+.[0-9]+.[0-9]+
        Uses:
        ↑ Back to Top

        [Build] Release Candidate Build​

        (release_candidate_build.yml)

        Builds release candidate (RC) staging builds for iOS and Android, triggered by an RC-v*.*.* tag pushed from new_release_branch.yml at the end of each sprint. Queues the build, notifies Slack, and runs iOS and Android RC builds in parallel for QA validation and regression testing.

        SourceRuns
        Triggers:
        • Push
          • Tags: RC-v[0-9]+.[0-9]+.[0-9]+-[0-9]+[0-9]+[0-9]+-[0-9]+[0-9]+
        Uses:
        ↑ Back to Top

        [Build] Reusable Android Build Workflow​

        (build_android.yml)

        Reusable Android build workflow. Sets up the Linux environment, installs dependencies, decodes signing keys, bundles the app, and runs the specified Fastlane lane (qa, rc, review, release, on_demand) to build and distribute.

        SourceRuns
        Triggers:
        Inputs:
        InputDescriptionTypeDefaultRequired
        environmentApp environment variables to use (test, staging, production)stringstagingNo
        laneFastlane lane to run (qa, rc, review, release, on_demand)stringqaNo
        notesRelease notes for Firebase (defaults to "New QA version for {{DATE_TIME}}")string""No
        ps_trackGoogle Play Console track to distribute to (defaults to "Development Team")string""No
        refBranch or tag to build from (defaults to triggering ref)string""No
        slack_thread_tsSlack thread timestamp for build status messagesstring""No
        versionVersion for production release (QA/on-demand builds auto-increment)stringqaNo
        ↑ Back to Top

        [Build] Reusable iOS Build Workflow​

        (build_ios.yml)

        Reusable iOS build workflow. Sets up the macOS environment, installs dependencies, decodes signing keys, bundles the app, and runs the specified Fastlane lane (qa, rc, review, release, on_demand) to build and distribute.

        SourceRuns
        Triggers:
        Inputs:
        InputDescriptionTypeDefaultRequired
        environmentApp environment variables to use (test, staging, production)stringstagingNo
        laneFastlane lane to run (qa, rc, review, release, on_demand)stringqaNo
        notesRelease notes for TestFlight (defaults to "New QA version for {{DATE_TIME}}")string""No
        refBranch or tag to build from (defaults to triggering ref)string""No
        slack_thread_tsSlack thread timestamp for build status messagesstring""No
        tf_groupTestFlight group to distribute to (defaults to "Development Team")string""No
        versionVersion for production release (QA/on-demand builds auto-increment)stringqaNo
        ↑ Back to Top

        [Code Quality] Check Native Android Builds​

        (native_build_check_android.yml)

        Verifies that changes to native Android files do not break the Android build process. Triggers on PRs that modify files under VAMobile/android/ and runs a test-only Android build via the reusable build_android workflow.

        SourceRuns
        Triggers:
        • Pull Request
          • File Paths:
            • VAMobile/android/**
        Uses:
        ↑ Back to Top

        [Code Quality] Check Native iOS Builds​

        (native_build_check_ios.yml)

        Verifies that changes to native iOS files do not break the iOS build process. Triggers on PRs that modify files under VAMobile/ios/ and runs a test-only iOS build via the reusable build_ios workflow.

        SourceRuns
        Triggers:
        • Pull Request
          • File Paths:
            • VAMobile/ios/**
        Uses:
        ↑ Back to Top

        [Code Quality] Code Checks​

        (code_checks.yml)

        Runs code quality checks on every PR and push to main/develop/release branches. Includes ESLint, Super-Linter, Jest unit tests (split across 5 matrix chunks), and Android/iOS bundle verification.

        SourceRuns
        Triggers:
        • Pull Request
        • Push
          • Branches: main, develop, release/v**
        ↑ Back to Top

        [Code Quality] CodeQL (JavaScript)​

        (codeql.yml)

        Runs GitHub CodeQL security analysis on JavaScript code. Triggers on pushes and PRs to develop and weekly on a schedule. Initializes CodeQL, autobuilds the project, and performs the analysis.

        SourceRuns
        Triggers:
        • Push
          • Branches: develop
        • Pull Request
          • Branches: develop
        • Schedule
          • Cron: 27 2 * * 1 (At 02:27 AM, only on Monday UTC)
        ↑ Back to Top

        [Code Quality] CodeQL (Multi-Language)​

        (codeql-analysis.yml)

        Runs GitHub CodeQL static analysis on Ruby, JavaScript, and Python code. Triggers on pushes and PRs to develop, weekly on a schedule, and manually. Uses the VA's shared codeql-tools action for scanning.

        SourceRuns
        Triggers:
        • Push
          • Branches: develop
        • Pull Request
          • Branches: develop
        • Schedule
          • Cron: 47 14 * * 1 (At 02:47 PM, only on Monday UTC)
        • Manual Trigger (workflow_dispatch)
        ↑ Back to Top

        [Code Quality] Update Bundler​

        (bundler_updates.yml)

        Updates Ruby bundler dependencies and Fastlane plugins for both Android and iOS every Wednesday. If any lock files change, commits and pushes them automatically.

        SourceRuns
        Triggers:
        • Schedule
          • Cron: 0 7 * * 3 (At 07:00 AM, only on Wednesday UTC)
        • Manual Trigger (workflow_dispatch)
        ↑ Back to Top

        [Documentation] Accessibility Check​

        (documentation_accessibility_checks.yml)

        Runs axe-core accessibility scans against every page of the documentation site on weekday mornings. Builds the Docusaurus site, crawls the sitemap, checks each URL for accessibility issues, and notifies Slack with the count of pages and errors found.

        SourceRuns
        Triggers:
        • Manual Trigger (workflow_dispatch)
        • Schedule
          • Cron: 0 9 * * 1,2,3,4,5 (At 09:00 AM, only on Monday, Tuesday, Wednesday, Thursday, and Friday UTC)
        Uses:
        ↑ Back to Top

        [Documentation] Deploy Site​

        (documentation_deploy.yml)

        Deploys the Docusaurus documentation site to GitHub Pages. Triggers on pushes to develop that touch documentation files, daily on a schedule, or manually. Builds the site and publishes to the gh-pages branch.

        SourceRuns
        Triggers:
        • Push
          • Branches: develop
          • File Paths:
            • VAMobile/documentation/**
        • Manual Trigger (workflow_dispatch)
        • Schedule
          • Cron: 0 3 * * * (At 03:00 AM UTC)
        ↑ Back to Top

        [Documentation] Test Build​

        (documentation_test_build.yml)

        Runs a test build of the Docusaurus documentation site on PRs targeting develop that touch components, documentation, or hooks. Verifies the documentation builds successfully without deploying.

        SourceRuns
        Triggers:
        • Pull Request
          • Branches: develop
          • File Paths:
            • VAMobile/src/components/**
            • VAMobile/documentation/**
            • VAMobile/src/utils/hooks.tsx
        ↑ Back to Top

        [E2E] Android Detox Test Run​

        (e2e_android.yml)

        Runs Detox e2e tests on Android emulator in CI. It bundles the Android app, determines which tests to run, executes them across a matrix, and reports failures to Slack and TestRail.

        SourceRuns
        Triggers:
        • Push
          • Branches: dependabot/**
        • Pull Request
          • When: Synchronize, Opened
          • File Paths:
            • VAMobile/src/**
            • VAMobile/e2e/**
            • VAMobile/package.json
            • .github/workflows/e2e_android.yml
            • .github/workflows/e2e_ios.yml
            • .github/workflows/e2e_detox_mapping.yml
        • Manual Trigger (workflow_dispatch)
          • Schedule
            • Cron: 0 4 * * 1,2,3,4,5 (At 04:00 AM, only on Monday, Tuesday, Wednesday, Thursday, and Friday UTC)
          • Triggered by other workflows (workflow_run)
          • Used by other workflows (workflow_call):
            Inputs:
            InputDescriptionTypeDefaultRequired
            run_full_testRun all testsboolean-No
            skip_cacheSkip build and dependency cachesboolean-No
            tests_to_runTests to run in ["test name", "test name"] format. Leave blank if running full e2e test.string-No
            testRail_nameName for TestRail run (will default to date if blank)string-No
            run_testRailAdd results to TestRail?boolean-No
            Uses:
            ↑ Back to Top

            [E2E] Detox Mapping​

            (e2e_detox_mapping.yml)

            Reusable workflow that determines which Detox e2e tests to run based on changed files in the PR. Reads the detoxMapping.js config to map source file and directory changes to their associated e2e test suites.

            SourceRuns
            Triggers:
            ↑ Back to Top

            [E2E] iOS Detox Test Run​

            (e2e_ios.yml)

            Runs Detox e2e tests on an iOS simulator in CI. It bundles the iOS app, determines which tests to run, executes them across a matrix, and reports failures to Slack and TestRail.

            SourceRuns
            Triggers:
            • Push
              • Branches: dependabot/**
            • Pull Request
              • When: Synchronize, Opened
              • File Paths:
                • VAMobile/src/**
                • VAMobile/e2e/**
                • VAMobile/package.json
                • .github/workflows/e2e_android.yml
                • .github/workflows/e2e_ios.yml
                • .github/workflows/e2e_detox_mapping.yml
            • Manual Trigger (workflow_dispatch)
              • Schedule
                • Cron: 0 4 * * 1,2,3,4,5 (At 04:00 AM, only on Monday, Tuesday, Wednesday, Thursday, and Friday UTC)
              • Triggered by other workflows (workflow_run)
              • Used by other workflows (workflow_call):
                Inputs:
                InputDescriptionTypeDefaultRequired
                run_full_testRun all testsboolean-No
                skip_cacheSkip build and dependency cachesboolean-No
                tests_to_runTests to run in ["test name", "test name"] format. Leave blank if running full e2e test.string-No
                testRail_nameName for TestRail run (will default to date if blank)string-No
                run_testRailAdd results to TestRail?boolean-No
                Uses:
                ↑ Back to Top

                [Release] Apple App Store Requirement Checks​

                (app_store_checks_apple.yml)

                Validates that PRs do not exceed Apple App Store limits for screenshot counts (iPhone, iPad), description length, release notes, keywords, and title. Runs on PRs targeting main/develop/release that touch iOS metadata.

                SourceRuns
                Triggers:
                • Pull Request
                  • Branches: main, develop, release/v**
                  • File Paths:
                    • VAMobile/ios/fastlane/metadata/en-US/**
                    • VAMobile/ios/fastlane/screenshots/**
                Uses:
                ↑ Back to Top

                [Release] Approve Slash Command​

                (approve_command.yml)

                Handles the /approve slash command dispatched from issue comments. Triggers the release PR creation process, comments on the release issue with PR links, closes the issue, and notifies Slack on failure. Note: this workflow is being phased out as the release process now uses run_approval.yml instead.

                SourceRuns
                Triggers:
                • Called by other repos or external events (repository_dispatch)
                  • When: Approve Command
                Uses:
                ↑ Back to Top

                [Release] Check Max File/Character Size​

                (check_max_size.yml)

                Reusable workflow that checks whether a file count or character count exceeds an app store limit. Called by app_store_checks_apple and app_store_checks_google to validate screenshots and metadata sizes.

                SourceRuns
                Triggers:
                Inputs:
                InputDescriptionTypeDefaultRequired
                working_dirDirectory to run the counting function instring-Yes
                max_sizeMaximum allowed count (files or characters)string-Yes
                counting_functionShell command that outputs the count to check against max_sizestring-Yes
                ↑ Back to Top

                [Release] Gather iOS and Android screenshots​

                (screenshot_e2e.yml)

                Generates App Store screenshots for iOS (iPhone and iPad) and Android using Detox e2e tests in CI. It builds and runs screenshot tests on each platform, combines and frames the images, and uploads them as a workflow artifact. Must be triggered manually.

                SourceRuns
                Triggers:
                • Manual Trigger (workflow_dispatch)
                Uses:
                ↑ Back to Top

                [Release] Go Live​

                (go_live.yml)

                Promotes release builds to production in the App Store and Google Play Store. Runs weekly on Tuesdays or manually. Checks environment protections, then triggers the iOS and Android Fastlane release lanes from the main branch.

                SourceRuns
                Triggers:
                • Manual Trigger (workflow_dispatch)
                • Schedule
                  • Cron: 0 12 * * 2 (At 12:00 PM, only on Tuesday UTC)
                Uses:
                ↑ Back to Top

                [Release] Google Play Store Requirement Checks​

                (app_store_checks_google.yml)

                Validates that PRs do not exceed Google Play Store limits for screenshot counts (phone, 7-inch tablet), description length, short description, changelog, and title. Runs on PRs targeting main/develop/release that touch Android metadata.

                SourceRuns
                Triggers:
                • Pull Request
                  • Branches: main, develop, release/v**
                  • File Paths:
                    • VAMobile/android/fastlane/metadata/android/en-US/**
                Uses:
                ↑ Back to Top

                [Release] Merge to Main and Open Develop PR​

                (release_pull_request.yml)

                Reusable release workflow that merges the release branch to main (squash merge), tags the release version, and creates a PR to merge release changes back into develop. Outputs the develop PR URL and release commit hash.

                SourceRuns
                Triggers:
                Inputs:
                InputDescriptionTypeDefaultRequired
                versionRelease version number (eg. v1.1.0)string-Yes
                ↑ Back to Top

                [Release] New Release Branch​

                (new_release_branch.yml)

                Cuts a new release branch from develop at the end of each sprint. Runs on a weekly schedule (Wednesdays) or manually. Executes the release_branch.sh script which creates the branch and tags it to trigger the RC build. On non-release weeks the scheduled run is a no-op (the script exits early based on date check).

                SourceRuns
                Triggers:
                • Manual Trigger (workflow_dispatch)
                • Schedule
                  • Cron: 00 6 * * 3 (At 06:00 AM, only on Wednesday UTC)
                ↑ Back to Top

                [Release] New Release Issue​

                (release_branch_issue.yml)

                Creates a release tracking issue when a new release branch is created. Generates the release ticket with due dates, assigns release approvers, creates a TestRail milestone and RC test run, closes the previous milestone, posts release coordination details to Slack, and waits for manual approval to trigger the release.

                SourceRuns
                Triggers:
                • Branch or Tag Created
                Uses:
                ↑ Back to Top

                [Release] Optimize App Store Screenshots​

                (optimize-images.yml)

                Optimizes App Store screenshots for iOS and Android on pushes to release branches. Uses imagemin to compress images in-place, then commits the optimized files back to the release branch.

                SourceRuns
                Triggers:
                • Push
                  • Branches: release/v[0-9]+.[0-9]+.[0-9]+
                ↑ Back to Top

                [Release] Run Release Approval​

                (run_approval.yml)

                Reusable release approval workflow. Triggers the release PR creation process, adds a rocket reaction to the approval comment, and comments on the release issue with the created PR links upon completion.

                SourceRuns
                Triggers:
                Inputs:
                InputDescriptionTypeDefaultRequired
                versionVersion number for the release (eg. v1.1.0)string-Yes
                issue_numberRelease issue number to comment on with PR linksstring-No
                comment_idComment ID to add reaction to (for approval feedback)string-No
                Uses:
                ↑ Back to Top

                [Security] Package Dependency Security Check​

                (security-scan.yml)

                Scans PRs for package.json dependency changes. Detects added, changed, or removed packages, runs GuardDog security analysis, generates a detailed review summary, and requires manual approval for dependency changes via the bypass-package-lock environment protection.

                SourceRuns
                Triggers:
                • Pull Request
                Uses:
                ↑ Back to Top

                [TestRail] Create TestRail Milestone​

                (create_testrail_milestone.yml)

                Reusable workflow that creates a new sprint milestone in TestRail. Sets the milestone name to the current two-week sprint date range, marks it as started, and outputs the milestone ID for use by downstream workflows.

                SourceRuns
                Triggers:
                ↑ Back to Top

                [TestRail] Start RC Run​

                (start_test_rail_run.yml)

                Reusable workflow that creates a new regression test run in TestRail for a release candidate. Fetches RC test cases, creates the run under the specified milestone, and outputs the TestRail run URL.

                SourceRuns
                Triggers:
                Inputs:
                InputDescriptionTypeDefaultRequired
                versionVersion Number (eg. v1.1.0)string-Yes
                releaseDateGo-live date for release (eg. 06/21/2022)string-Yes
                ticketNumberIssue number for release ticket (eg. 3333)string-Yes
                milestoneIdMilestone id for the run to be associated withstring-Yes
                ↑ Back to Top

                [TestRail] Update E2E Results​

                (update_testrail_results.yml)

                Reusable workflow that uploads e2e Detox test results (JUnit XML) to TestRail. Finds or creates the appropriate test run, then uses the trcli tool to parse and upload results for each test suite.

                SourceRuns
                Triggers:
                Inputs:
                InputDescriptionTypeDefaultRequired
                testRail_nameName for the TestRail run (defaults to current date if blank)string""No
                test_OS_nameOS name for the test run (e.g. iOS or Android)string""No
                ↑ Back to Top

                [TestRail] Update Run​

                (update_testrail_run.yml)

                Receives a repository_dispatch webhook from TestRail and updates the associated release issue's body with a pie chart showing test run results (passed, blocked, retest, failed, untested).

                SourceRuns
                Triggers:
                • Called by other repos or external events (repository_dispatch)
                  • When: Update Testrail Run
                ↑ Back to Top

                [Utils] Check Maintenance Windows​

                (check_maintenance_windows.yml)

                Checks PagerDuty maintenance windows daily and updates them via a Python script. Notifies Slack on success or failure. Can also be triggered manually.

                SourceRuns
                Triggers:
                • Manual Trigger (workflow_dispatch)
                • Schedule
                  • Cron: 00 4 * * * (At 04:00 AM UTC)
                Uses:
                ↑ Back to Top

                [Utils] FE PR Needs Review Reminder​

                (pr_needs_review_reminder.yml)

                Manually triggered workflow that counts open PRs labeled 'FE-Needs Review' and posts the count to a Slack channel as a reminder for the team to review pending frontend PRs.

                SourceRuns
                Triggers:
                • Manual Trigger (workflow_dispatch)
                  ↑ Back to Top

                  [Utils] Lookup Slack User ID​

                  (get-slack-user-id.yml)

                  Reusable workflow that looks up a Slack user ID from a VA email address or GitHub handle. Maps git handles to emails via a repository variable, validates the @va.gov domain, and queries the Slack API to find the user ID.

                  SourceRuns
                  Triggers:
                  Inputs:
                  InputDescriptionTypeDefaultRequired
                  va_emailVA Email address to lookup Slack ID forstring-No
                  git_handleGit handle to lookup email and then Slack ID forstring-No
                  ↑ Back to Top

                  [Utils] Slash Command Dispatch​

                  (slash_commands.yml)

                  Listens for issue comments and dispatches recognized slash commands (currently /approve) to their corresponding workflow handlers. Uses the peter-evans/slash-command-dispatch action for parsing and dispatching.

                  SourceRuns
                  Triggers:
                  • Issue Comment
                    • When: Created
                  ↑ Back to Top

                  [Utils] Start Slack Thread​

                  (start_slack_thread.yml)

                  Reusable workflow that posts a message to a Slack channel to start a thread. Looks up the channel ID by name, posts the message, and outputs the thread timestamp and channel ID for downstream workflows to reply to.

                  SourceRuns
                  Triggers:
                  Inputs:
                  InputDescriptionTypeDefaultRequired
                  channel_nameName of the Slack channel where the thread should be started.stringva-mobile-build-alertsNo
                  messageText to display for the message starting the thread.string-Yes
                  ↑ Back to Top