feat(deploy): generate QR code locally with qrencode

- Replace external QR service with local qrencode generation
- QR code embedded as base64 data URI (no external API calls)
- Add test workflow for QR generation, input validation, payload construction
- Add justfile for development tasks (auto-manages podman)
- Update CONTRIBUTING.md with simplified testing instructions

Author: robbertbos

.pre-commit-ci.yaml

@@ -0,0 +1,4 @@
+ci:
+  autoupdate_schedule: weekly
+  # Skip hooks that are already run by CI workflow (avoid duplicates)
+  skip: [shellcheck, actionlint, yamllint]

.pre-commit-config.yaml

@@ -17,3 +17,9 @@ repos:
       - id: end-of-file-fixer
       - id: check-yaml
       - id: check-added-large-files
+
+  - repo: https://github.com/adrienverge/yamllint
+    rev: v1.35.1
+    hooks:
+      - id: yamllint
+        args: [-d, "{extends: relaxed, rules: {line-length: {max: 150}}}"]

CHANGELOG.md

@@ -12,6 +12,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - Automatically post/update a comment on PRs with the deployment URL
   - New inputs: `comment-on-pr`, `github-token`, `comment-header`
   - Upsert behavior: updates existing comment instead of creating duplicates
+- **deploy** action: QR code in PR comment
+  - New input: `qr-code` (default: `true`)
+  - QR code for easy mobile testing of preview deployments
+  - Generated locally using `qrencode` (no external API calls, privacy-friendly)
 - **cleanup** action: PR comment update feature
   - Update the deploy PR comment to show cleanup status when PR is closed
   - New inputs: `update-pr-comment`, `comment-header`
@@ -23,6 +27,10 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - SECURITY.md with security policy
 - Pre-commit hooks configuration
 
+### Internal
+- Added justfile for common development tasks
+- Added pre-commit.ci configuration (weekly autoupdates, skip duplicates with CI)
+
 ### Fixed
 - ShellCheck warnings: properly quoted GITHUB_OUTPUT
 - Actionlint configuration to only lint workflow files

CONTRIBUTING.md

@@ -7,6 +7,7 @@ Thank you for your interest in contributing to ZAD Actions!
 ### Prerequisites
 
 - Git
+- [just](https://github.com/casey/just) (command runner)
 - [pre-commit](https://pre-commit.com/) (for local linting)
 - [ShellCheck](https://www.shellcheck.net/) (for bash script linting)
 - [actionlint](https://github.com/rhysd/actionlint) (for GitHub Actions validation)
@@ -37,10 +38,14 @@ pre-commit run --all-files
 
 ### Testing Locally
 
-Run the pre-commit hooks to validate your changes:
+Use the justfile for common tasks:
 
 ```bash
-pre-commit run --all-files
+# List available commands
+just
+
+# Run linting
+just lint
 ```
 
 ### Testing in a Workflow

deploy/README.md

@@ -17,6 +17,7 @@ Deploys a container image to ZAD Operations Manager.
 | `comment-on-pr` | No | `false` | Post/update a comment on the PR with the deployment URL |
 | `github-token` | No | `''` | GitHub token for PR commenting (needs `pull-requests: write`) |
 | `comment-header` | No | `## 🚀 Preview Deployment` | Custom header for the PR comment |
+| `qr-code` | No | `true` | Include QR code for mobile access (generated locally via qrencode) |
 
 ## Outputs
 
@@ -86,12 +87,16 @@ The action will create a comment like this on the PR:
 
 > ## 🚀 Preview Deployment
 >
+> <img src="data:image/png;base64,..." width="100" height="100" align="right" alt="QR code">
+>
 > Your changes have been deployed to a preview environment:
 >
 > **URL:** https://web-pr123-my-project.rig.prd1.gn2.quattro.rijksapps.nl
 >
 > This deployment will be automatically cleaned up when the PR is closed.
 
+The QR code is generated locally using `qrencode` (no external API calls), making it easy to open the preview on your phone for mobile testing. To disable it, set `qr-code: false`.
+
 On subsequent deployments to the same PR, the existing comment is updated instead of creating a new one.
 
 ### Use with GitHub Environment

deploy/action.yml

@@ -47,6 +47,10 @@ inputs:
     description: 'Custom header for the PR comment (default: "## 🚀 Preview Deployment")'
     required: false
     default: '## 🚀 Preview Deployment'
+  qr-code:
+    description: 'Include QR code in PR comment for mobile access (generated locally via qrencode)'
+    required: false
+    default: 'true'
 
 outputs:
   url:
@@ -181,6 +185,22 @@ runs:
           exit 1
         fi
 
+    - name: Generate QR code
+      id: qr
+      if: inputs.qr-code == 'true' && inputs.comment-on-pr == 'true' && github.event_name == 'pull_request'
+      shell: bash
+      env:
+        DEPLOYMENT_URL: ${{ steps.deploy.outputs.url }}
+      run: |
+        sudo apt-get install -y qrencode >/dev/null 2>&1 || true
+        if command -v qrencode &> /dev/null; then
+          QR_BASE64=$(qrencode -o - -t PNG -s 4 -m 1 "$DEPLOYMENT_URL" | base64 -w0)
+          IMG="<img src='data:image/png;base64,${QR_BASE64}' width='100' height='100' align='right' alt='QR code'>"
+          echo "html=${IMG}" >> "$GITHUB_OUTPUT"
+        else
+          echo "Warning: qrencode not available, skipping QR code"
+        fi
+
     - name: Comment on PR
       if: inputs.comment-on-pr == 'true' && inputs.github-token != '' && github.event_name == 'pull_request'
       shell: bash
@@ -190,15 +210,16 @@ runs:
         COMMENT_HEADER: ${{ inputs.comment-header }}
         PR_NUMBER: ${{ github.event.pull_request.number }}
         GITHUB_REPOSITORY: ${{ github.repository }}
+        QR_HTML: ${{ steps.qr.outputs.html }}
       run: |
         # Build the comment body
-        COMMENT_BODY="${COMMENT_HEADER}
-
-        Your changes have been deployed to a preview environment:
-
-        **URL:** ${DEPLOYMENT_URL}
-
-        This deployment will be automatically cleaned up when the PR is closed."
+        COMMENT_BODY="${COMMENT_HEADER}"$'\n\n'
+        if [ -n "$QR_HTML" ]; then
+          COMMENT_BODY+="${QR_HTML}"$'\n\n'
+        fi
+        COMMENT_BODY+="Your changes have been deployed to a preview environment:"$'\n\n'
+        COMMENT_BODY+="**URL:** ${DEPLOYMENT_URL}"$'\n\n'
+        COMMENT_BODY+="This deployment will be automatically cleaned up when the PR is closed."
 
         # Check for existing comment from this action (identified by header)
         EXISTING_COMMENT_ID=$(gh api "repos/${GITHUB_REPOSITORY}/issues/${PR_NUMBER}/comments" \

justfile

@@ -0,0 +1,7 @@
+[private]
+default:
+    @just --list
+
+# Run pre-commit hooks on all files
+lint:
+    pre-commit run --all-files