docs

.github/workflows/build.yml

@@ -19,7 +19,7 @@ jobs:
     runs-on: ubuntu-24.04
     steps:
       - name: ⬆️ Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
       - name: 🔧 Setup java
         uses: actions/setup-java@v5
         with:
@@ -153,7 +153,7 @@ jobs:
         working-directory: app
     steps:
       - name: ⬆️ Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
       - name: Make yq tool available on Windows runners
         run: |
           choco install yq
@@ -213,7 +213,7 @@ jobs:
         working-directory: app
     steps:
       - name: ⬆️ Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
       - name: 🦀 Setup Rust
         uses: actions-rust-lang/setup-rust-toolchain@v1
         with:
@@ -262,7 +262,7 @@ jobs:
         working-directory: app
     steps:
       - name: ⬆️ Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
       - name: Get dependencies
         run: |
           sudo apt-get update
@@ -406,7 +406,7 @@ jobs:
     runs-on: ${{ matrix.arch.image }}
     steps:
       - name: ⬆️ Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
       - name: Add snapcraft directory
         run: |
           mkdir -p snap
@@ -433,15 +433,15 @@ jobs:
         working-directory: app
     steps:
       - name: ⬆️ Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
       - name: 🦀 Setup Rust
         uses: actions-rust-lang/setup-rust-toolchain@v1
         with:
           rust-src-dir: app
       - uses: subosito/flutter-action@v2.23.0
         with:
           flutter-version-file: app/pubspec.yaml
-      - uses: actions/setup-python@v6
+      - uses: actions/setup-python@v7
         with:
           python-version: "3.13"
       - name: ✅ Enable platforms
@@ -458,9 +458,9 @@ jobs:
         working-directory: app/build/macos/Build/Products/Release
         run: zip --symlinks -qr linwood-butterfly-macos.zip butterfly.app
       - name: Setup node
-        uses: actions/setup-node@v6
+        uses: actions/setup-node@v7
         with:
-          node-version: 24
+          node-version: 26
       - name: Install appdmg
         run: |
           python3 -m pip install setuptools
@@ -489,7 +489,7 @@ jobs:
         working-directory: app
     steps:
       - name: ⬆️ Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
       - name: 🦀 Setup Rust
         uses: actions-rust-lang/setup-rust-toolchain@v1
         with:
@@ -526,7 +526,7 @@ jobs:
     if: github.event_name != 'pull_request'
     steps:
       - name: ⬆️ Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
       - name: Set Docker tag
         id: docker_tag
         run: |
@@ -572,7 +572,7 @@ jobs:
       - build-ipa
     steps:
       - name: ⬆️ Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         env:
           CI_PAT: ${{ secrets.CI_PAT }}
         with:
@@ -870,7 +870,7 @@ jobs:
       PLAY_STORE_CREDENTIALS: ${{ secrets.PLAY_STORE_CREDENTIALS }}
     steps:
       - name: ⬆️ Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
         with:
           token: ${{ secrets.CI_PAT }}
       - name: Setup git
@@ -904,7 +904,7 @@ jobs:
       - name: Setup Fastlane
         uses: ruby/setup-ruby@v1
         with:
-          ruby-version: "4.0.5"
+          ruby-version: "4.0.6"
           bundler-cache: true
           working-directory: app/android
       - name: 🚀 Deploy to Play Store
@@ -923,7 +923,7 @@ jobs:
     needs: [deploy]
     runs-on: windows-latest
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v7
         with:
           token: ${{ secrets.CI_PAT }}
       - if: ${{ github.ref == 'refs/tags/stable' }}
@@ -940,3 +940,211 @@ jobs:
           version: ${{ needs.deploy.outputs.version }}
           release-tag: v${{ needs.deploy.outputs.version }}
           token: ${{ secrets.CI_PAT }}
+  update-flathub-beta:
+    name: Update Flathub beta
+    needs:
+      - deploy
+    if: >-
+      ${{
+        github.event_name == 'release' &&
+        github.event.action == 'published' &&
+        github.event.release.prerelease == true
+      }}
+    runs-on: ubuntu-24.04
+
+    permissions:
+      contents: read
+
+    concurrency:
+      group: flathub-beta-${{ github.event.release.tag_name }}
+      cancel-in-progress: false
+
+    env:
+      FLATHUB_REPOSITORY: flathub/dev.linwood.butterfly
+      FLATHUB_MANIFEST: dev.linwood.butterfly.json
+      RELEASE_TAG: ${{ github.event.release.tag_name }}
+
+    steps:
+      - name: Download release checksums
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          mkdir -p release
+
+          for attempt in {1..12}; do
+            rm -f release/checksums.txt
+
+            if gh release download "$RELEASE_TAG" \
+              --repo "$GITHUB_REPOSITORY" \
+              --pattern checksums.txt \
+              --dir release; then
+              break
+            fi
+
+            echo "Release assets are not available yet, retrying..."
+            sleep 10
+          done
+
+          test -s release/checksums.txt
+
+      - name: Read Linux checksums
+        id: checksums
+        run: |
+          X86_64_SHA="$(
+            awk '$2 == "linwood-butterfly-linux-x86_64.tar.gz" {
+              print $1
+            }' release/checksums.txt
+          )"
+
+          ARM64_SHA="$(
+            awk '$2 == "linwood-butterfly-linux-arm64.tar.gz" {
+              print $1
+            }' release/checksums.txt
+          )"
+
+          if [[ ! "$X86_64_SHA" =~ ^[0-9a-f]{64}$ ]]; then
+            echo "Invalid or missing x86_64 checksum"
+            exit 1
+          fi
+
+          if [[ ! "$ARM64_SHA" =~ ^[0-9a-f]{64}$ ]]; then
+            echo "Invalid or missing arm64 checksum"
+            exit 1
+          fi
+
+          echo "x86_64=$X86_64_SHA" >> "$GITHUB_OUTPUT"
+          echo "arm64=$ARM64_SHA" >> "$GITHUB_OUTPUT"
+
+      - name: Checkout Flathub beta branch
+        uses: actions/checkout@v7
+        with:
+          repository: flathub/dev.linwood.butterfly
+          ref: beta
+          token: ${{ secrets.CI_PAT }}
+          fetch-depth: 0
+          path: flathub
+
+      - name: Update Flathub manifest
+        env:
+          X86_64_SHA: ${{ steps.checksums.outputs.x86_64 }}
+          ARM64_SHA: ${{ steps.checksums.outputs.arm64 }}
+        run: |
+          python3 <<'PY'
+          import os
+          import re
+          from pathlib import Path
+
+          manifest = Path("flathub") / os.environ["FLATHUB_MANIFEST"]
+          release_tag = os.environ["RELEASE_TAG"]
+
+          files = {
+              "linwood-butterfly-linux-x86_64.tar.gz": os.environ["X86_64_SHA"],
+              "linwood-butterfly-linux-arm64.tar.gz": os.environ["ARM64_SHA"],
+          }
+
+          lines = manifest.read_text(encoding="utf-8").splitlines()
+          updated = set()
+
+          for index, line in enumerate(lines):
+              for filename, checksum in files.items():
+                  if '"url":' not in line or filename not in line:
+                      continue
+
+                  indent = line[: len(line) - len(line.lstrip())]
+                  lines[index] = (
+                      f'{indent}"url": '
+                      f'"https://github.com/LinwoodDev/Butterfly/'
+                      f'releases/download/{release_tag}/{filename}",'
+                  )
+
+                  for checksum_index in range(
+                      index + 1,
+                      min(index + 6, len(lines)),
+                  ):
+                      if '"sha256":' not in lines[checksum_index]:
+                          continue
+
+                      lines[checksum_index] = re.sub(
+                          r'"sha256":\s*"[^"]+"',
+                          f'"sha256": "{checksum}"',
+                          lines[checksum_index],
+                      )
+                      updated.add(filename)
+                      break
+
+          missing = set(files) - updated
+          if missing:
+              raise RuntimeError(
+                  f"Could not update manifest entries: {sorted(missing)}"
+              )
+
+          manifest.write_text(
+              "\n".join(lines) + "\n",
+              encoding="utf-8",
+          )
+          PY
+
+      - name: Commit and push update branch
+        id: push
+        working-directory: flathub
+        run: |
+          VERSION="${RELEASE_TAG#v}"
+          BRANCH="automation/butterfly-$VERSION"
+
+          echo "branch=$BRANCH" >> "$GITHUB_OUTPUT"
+
+          if git diff --quiet -- "$FLATHUB_MANIFEST"; then
+            echo "Manifest already contains this release"
+            echo "changed=false" >> "$GITHUB_OUTPUT"
+            exit 0
+          fi
+
+          git config user.name "Linwood CI"
+          git config user.email "ci@linwood.dev"
+
+          git checkout -B "$BRANCH"
+          git add "$FLATHUB_MANIFEST"
+          git commit -m "Update Butterfly to $VERSION"
+          git push --force origin "HEAD:refs/heads/$BRANCH"
+
+          echo "changed=true" >> "$GITHUB_OUTPUT"
+
+      - name: Create Flathub beta pull request
+        if: steps.push.outputs.changed == 'true'
+        env:
+          GH_TOKEN: ${{ secrets.CI_PAT }}
+          BRANCH: ${{ steps.push.outputs.branch }}
+        run: |
+          EXISTING_PR="$(
+            gh pr list \
+              --repo "$FLATHUB_REPOSITORY" \
+              --base beta \
+              --head "$BRANCH" \
+              --state open \
+              --json number \
+              --jq '.[0].number // empty'
+          )"
+
+          if [[ -n "$EXISTING_PR" ]]; then
+            echo "Pull request #$EXISTING_PR already exists"
+            exit 0
+          fi
+
+          VERSION="${RELEASE_TAG#v}"
+
+          cat > /tmp/flathub-pr.md <<EOF
+          Automated update for Butterfly $VERSION.
+
+          Release:
+          $GITHUB_SERVER_URL/$GITHUB_REPOSITORY/releases/tag/$RELEASE_TAG
+
+          The download URLs and SHA256 checksums for the x86_64 and arm64
+          Linux archives were generated from the published release assets.
+          EOF
+
+          gh pr create \
+            --repo "$FLATHUB_REPOSITORY" \
+            --base beta \
+            --head "$BRANCH" \
+            --title "Update Butterfly to $VERSION" \
+            --body-file /tmp/flathub-pr.md

.github/workflows/calibreapp-image-actions.yml

@@ -16,7 +16,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout Repo
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
 
       - name: Compress Images
         uses: calibreapp/image-actions@main

.github/workflows/compress-images.yml

@@ -11,7 +11,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout Repo
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
       - name: Compress Images
         id: calibre
         uses: calibreapp/image-actions@main

.github/workflows/dart.yml

@@ -13,7 +13,7 @@ jobs:
         working-directory: ${{ matrix.projects }}
     steps:
       - name: ⬆️ Checkout
-        uses: actions/checkout@v6
+        uses: actions/checkout@v7
       - uses: subosito/flutter-action@v2.23.0
         with:
           flutter-version-file: app/pubspec.yaml