From 46b7a484e6bc5296ec3c83ba83db69c9cf6b83f0 Mon Sep 17 00:00:00 2001
From: tafilovic <sekitafilovic@gmail.com>
Date: Tue, 31 Mar 2026 14:15:16 +0200
Subject: [PATCH 1/3] Fix for publishing

---
 .github/workflows/tag-release.yml |  2 ++
 INSTRUCTIONS.md                   | 20 +++++++++++++++++++-
 2 files changed, 21 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/tag-release.yml b/.github/workflows/tag-release.yml
index 9c8206f..db1350d 100644
--- a/.github/workflows/tag-release.yml
+++ b/.github/workflows/tag-release.yml
@@ -19,6 +19,8 @@ jobs:
 
     steps:
       - uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.RELEASE_TOKEN }}
 
       - name: Validate version sync (pubspec.yaml vs input)
         run: |
diff --git a/INSTRUCTIONS.md b/INSTRUCTIONS.md
index 37b0c7c..4d167e1 100644
--- a/INSTRUCTIONS.md
+++ b/INSTRUCTIONS.md
@@ -147,7 +147,22 @@ This only needs to be done once per package. It authorizes GitHub Actions to pub
 6. Enable the **"Allow workflow_dispatch"** checkbox
 7. Click **Save**
 
-### Step 2 — Verify the GitHub Actions workflows are present
+### Step 2 — Create a Personal Access Token (PAT) for workflow chaining
+
+GitHub Actions workflows triggered by `GITHUB_TOKEN` (the default) cannot trigger other workflows. The `Tag and Release` workflow needs a PAT so that its tag push is treated as a real user action and cascades into the `Publish` workflow.
+
+1. GitHub → profile avatar → **Settings**
+2. **Developer settings** → **Personal access tokens** → **Fine-grained tokens**
+3. Click **Generate new token**, set:
+   - **Repository access:** `mapp-digital/Mapp-Intelligence-Flutter-Tracking`
+   - **Permissions:** `Contents` → **Read and write**
+4. Click **Generate token** → copy it
+5. Go to the repo → **Settings** → **Secrets and variables** → **Actions**
+6. Click **New repository secret**:
+   - Name: `RELEASE_TOKEN`
+   - Value: paste the PAT
+
+### Step 3 — Verify the GitHub Actions workflows are present
 
 Confirm these three files exist in the repository:
 
@@ -257,5 +272,8 @@ Run `dart pub publish --dry-run` locally to see the exact issues. Common causes:
 - Files referenced in `pubspec.yaml` that don't exist
 - Dart files with analysis errors
 
+### Tag and Release runs successfully but Publish workflow never starts
+GitHub blocks workflow-to-workflow triggering when the default `GITHUB_TOKEN` is used. The `RELEASE_TOKEN` PAT secret must be set up (see Section 5, Step 2). Without it, the tag is pushed but GitHub treats it as an automated action and suppresses downstream workflow triggers.
+
 ### OIDC authentication fails in CI
 Verify the pub.dev admin setup in Section 5 is complete and the repository name matches exactly (`mapp-digital/Mapp-Intelligence-Flutter-Tracking`).

From 31db5f79e319623842e887aaaf402e3d3464538e Mon Sep 17 00:00:00 2001
From: tafilovic <sekitafilovic@gmail.com>
Date: Tue, 31 Mar 2026 14:16:24 +0200
Subject: [PATCH 2/3] Update tag-release.yml to delete the tag first if it
 already exists

---
 .github/workflows/tag-release.yml | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/.github/workflows/tag-release.yml b/.github/workflows/tag-release.yml
index db1350d..47be0b8 100644
--- a/.github/workflows/tag-release.yml
+++ b/.github/workflows/tag-release.yml
@@ -36,5 +36,12 @@ jobs:
         run: |
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
-          git tag "v${{ github.event.inputs.version }}"
-          git push origin "v${{ github.event.inputs.version }}"
+          TAG="v${{ github.event.inputs.version }}"
+          # Delete existing tag locally and remotely if it exists
+          if git rev-parse "$TAG" >/dev/null 2>&1; then
+            echo "Tag $TAG already exists — deleting and recreating"
+            git tag -d "$TAG"
+            git push origin --delete "$TAG" || true
+          fi
+          git tag "$TAG"
+          git push origin "$TAG"

From 1a54777566ceeae6404ac2f6c46f12494808e1e9 Mon Sep 17 00:00:00 2001
From: tafilovic <sekitafilovic@gmail.com>
Date: Tue, 31 Mar 2026 14:30:30 +0200
Subject: [PATCH 3/3] Updated Tag & Release

---
 .github/workflows/tag-release.yml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/.github/workflows/tag-release.yml b/.github/workflows/tag-release.yml
index 47be0b8..315d0a9 100644
--- a/.github/workflows/tag-release.yml
+++ b/.github/workflows/tag-release.yml
@@ -20,7 +20,7 @@ jobs:
     steps:
       - uses: actions/checkout@v4
         with:
-          token: ${{ secrets.RELEASE_TOKEN }}
+          token: ${{ secrets.RELEASE_TOKEN || secrets.GITHUB_TOKEN }}
 
       - name: Validate version sync (pubspec.yaml vs input)
         run: |