Add skip-bundle-size-check script for bypassing size check

When an intentional size increase exceeds the 0.5KB threshold:
1. Run `bin/skip-bundle-size-check` to set the current branch
2. Commit and push the .bundle-size-skip-branch file
3. The CI will skip the size check for that branch

The workflow uses a two-job approach: check-skip runs first, and
the size job only runs if the branch isn't in the skip file.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: AbanoubGhadban

.bundle-size-skip-branch

@@ -0,0 +1,6 @@
+# This file allows skipping the bundle size CI check for a specific branch.
+# When a branch name in this file matches the PR branch, the size check is skipped.
+#
+# Usage: Run `bin/skip-bundle-size-check` to set the current branch, then commit and push.
+#
+# This is useful when you have an intentional size increase that exceeds the 0.5KB threshold.

.github/workflows/bundle-size.yml

@@ -8,9 +8,33 @@ on:
       - 'pnpm-lock.yaml'
       - '.size-limit.json'
       - '.github/workflows/bundle-size.yml'
+      - '.bundle-size-skip-branch'
 
 jobs:
+  check-skip:
+    runs-on: ubuntu-22.04
+    outputs:
+      skip: ${{ steps.skip-check.outputs.skip }}
+    steps:
+      - name: Checkout PR branch
+        uses: actions/checkout@v4
+
+      - name: Check if branch should skip size check
+        id: skip-check
+        run: |
+          SKIP_FILE=".bundle-size-skip-branch"
+          BRANCH="${{ github.head_ref }}"
+          SKIP_BRANCH=$(grep -v '^[[:space:]]*#' "$SKIP_FILE" 2>/dev/null | grep -v '^[[:space:]]*$' | tr -d '[:space:]' || echo "")
+          if [ "$SKIP_BRANCH" = "$BRANCH" ]; then
+            echo "skip=true" >> $GITHUB_OUTPUT
+            echo "::notice::Branch '$BRANCH' is set to skip size check"
+          else
+            echo "skip=false" >> $GITHUB_OUTPUT
+          fi
+
   size:
+    needs: check-skip
+    if: needs.check-skip.outputs.skip != 'true'
     runs-on: ubuntu-22.04
     permissions:
       contents: read

bin/skip-bundle-size-check

@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+#
+# Skip bundle size check for current branch
+#
+# Usage:
+#   bin/skip-bundle-size-check
+#
+
+set -e
+
+SKIP_FILE=".bundle-size-skip-branch"
+BRANCH=$(git branch --show-current)
+
+if [ -z "$BRANCH" ]; then
+  echo "Error: Not on a branch (detached HEAD?)"
+  exit 1
+fi
+
+# Write comment header and branch name
+cat > "$SKIP_FILE" << EOF
+# This file allows skipping the bundle size CI check for a specific branch.
+# When a branch name in this file matches the PR branch, the size check is skipped.
+#
+# Usage: Run \`bin/skip-bundle-size-check\` to set the current branch, then commit and push.
+#
+# This is useful when you have an intentional size increase that exceeds the 0.5KB threshold.
+$BRANCH
+EOF
+echo "Set '$BRANCH' as the branch to skip bundle size check"
+echo ""
+echo "Next steps:"
+echo "  git add $SKIP_FILE"
+echo "  git commit -m 'Skip bundle size check for $BRANCH'"
+echo "  git push"