GitHub Actions

steps ٹیمپلیٹ کا استعمال کرتے ہوئے اپنی لاک اسکرین پر CI/CD ورک فلو کی پیش رفت ریئل ٹائم میں ٹریک کریں۔

How It Works

The pushward-github bridge container polls the GitHub Actions API for in-progress workflow runs and maps workflow progress to Live Activities using the steps template.

1. Idle polling -- checks all configured repos every 60s for in-progress workflows
2. Active tracking -- on each poll cycle the bridge fetches the tracked run's jobs and updates progress
3. Cleanup -- after the workflow completes, the activity is cleaned up after a configurable delay (default 15 min)

Setup

1. Get Your Integration Key

PushWard ایپ میں Settings → Integration Key کے تحت اپنی ڈیفالٹ انٹیگریشن کلید کاپی کریں؛ یہ سائن اِن کرنے پر خودکار طور پر بن جاتی ہے۔ کسی کلید کو اِس انٹیگریشن تک محدود کرنے کے لیے، محدود دائرہ کار کلیدیں بنانا دیکھیں۔

2. Create a GitHub Personal Access Token

Create a fine-grained PAT with actions:read permission on the repos you want to track.

3. Deploy the Bridge

services:
  pushward-github:
    image: ghcr.io/mac-lucky/pushward-github:latest
    environment:
      PUSHWARD_URL: https://api.pushward.app
      PUSHWARD_API_KEY: hlk_YOUR_INTEGRATION_KEY
      PUSHWARD_GITHUB_TOKEN: github_pat_YOUR_GITHUB_TOKEN
      PUSHWARD_GITHUB_OWNER: your-username  # auto-discovers all repos
      # OR specify repos explicitly:
      # PUSHWARD_GITHUB_REPOS: owner/repo1,owner/repo2
    restart: unless-stopped

Configuration

Activity Slug Format

Activities are created with the slug gh-<8 hex chars>, derived from SHA-256(owner/repo) (e.g. gh-1a2b3c4d). One run is tracked per repository at a time.