Document Docker API version and fallback behavior

Add comment explaining that pullViaDockerAPI uses API v1.44 (Docker 25.0+)
and that older versions gracefully fall back to CLI-based pulling.

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

.all-contributorsrc

@@ -1,6 +1,7 @@
 {
   "files": [
-    "website/src/pages/credits.mdx"
+    "website/src/pages/credits.mdx",
+    "docs/src/assets/contributors.html"
   ],
   "imageSize": 75,
   "commit": false,

.coderabbit.yaml

@@ -0,0 +1,71 @@
+language: en-US
+tone_instructions: ''
+early_access: false
+enable_free_tier: true
+reviews:
+  profile: chill
+  request_changes_workflow: false
+  high_level_summary: true
+  high_level_summary_placeholder: '@coderabbitai summary'
+  auto_title_placeholder: '@coderabbitai'
+  review_status: true
+  poem: true
+  collapse_walkthrough: false
+  sequence_diagrams: true
+  path_filters: []
+  path_instructions: []
+  abort_on_close: true
+  auto_review:
+    enabled: true
+    auto_incremental_review: true
+    ignore_title_keywords: []
+    labels: []
+    drafts: false
+    base_branches: ['v3-alpha', 'master']
+  tools:
+    shellcheck:
+      enabled: true
+    ruff:
+      enabled: true
+    markdownlint:
+      enabled: true
+    github-checks:
+      enabled: true
+      timeout_ms: 90000
+    languagetool:
+      enabled: true
+      enabled_only: false
+      level: default
+    biome:
+      enabled: true
+    hadolint:
+      enabled: true
+    swiftlint:
+      enabled: true
+    phpstan:
+      enabled: true
+      level: default
+    golangci-lint:
+      enabled: true
+    yamllint:
+      enabled: true
+    gitleaks:
+      enabled: true
+    checkov:
+      enabled: true
+    detekt:
+      enabled: true
+    eslint:
+      enabled: true
+chat:
+  auto_reply: true
+knowledge_base:
+  opt_out: false
+  learnings:
+    scope: auto
+  issues:
+    scope: auto
+  jira:
+    project_keys: []
+  linear:
+    team_keys: []

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -7,6 +7,8 @@ body:
   - type: markdown
     attributes:
       value: |
+        ***Please note: No bug reports are currently being accepted for Wails v3***
+        ***Please note: No bug reports are currently being accepted for Wails v3***
         ***Please note: No bug reports are currently being accepted for Wails v3***
         Before submitting this issue, please do the following:
         - Do a web search for your error. This usually leads to a much better understanding of the issue.

.github/file-labeler.yml

@@ -0,0 +1,44 @@
+# File path specific labels
+v2-only:
+  - 'v2/**/*'
+
+v3-alpha:
+  - 'v3/**/*'
+
+windows:
+  - '**/*_windows.go'
+  - 'v2/internal/frontend/desktop/windows/**/*'
+
+macos:
+  - '**/*_darwin.go'
+  - 'v2/internal/frontend/desktop/darwin/**/*'
+
+linux:
+  - '**/*_linux.go'
+  - 'v2/internal/frontend/desktop/linux/**/*'
+
+cli:
+  - 'v2/cmd/**/*'
+  - 'v3/cmd/**/*'
+  - '**/cli/**/*'
+  - '**/commands/**/*'
+  
+documentation:
+  - '**/*.md'
+  - 'docs/**/*'
+  - 'website/**/*'
+  - 'mkdocs-website/**/*'
+
+templates:
+  - '**/templates/**/*'
+  - '**/template/**/*'
+
+runtime:
+  - '**/runtime/**/*'
+  - 'v2/internal/runtime/**/*'
+  - 'v3/internal/runtime/**/*'
+  
+bindings:
+  - 'v2/internal/binding/**/*'
+  - 'v3/internal/generator/**/*'
+

.github/issue-labeler.yml

@@ -0,0 +1,144 @@
+# Version labels
+v2-only:
+  - '\[v2\]'
+  - '\(v2\)'
+  - 'v2:'
+  - 'version 2'
+  - 'wails v2'
+  - 'using v2'
+  - 'master branch'
+
+v3-alpha:
+  - '\[v3\]'
+  - '\(v3\)'
+  - 'v3:'
+  - '\[v3-alpha\]'
+  - '\(v3-alpha\)'
+  - 'version 3'
+  - 'wails v3'
+  - 'using v3'
+  - 'v3-alpha branch'
+
+# Component labels
+webview2:
+  - 'webview2'
+  - 'windows'
+  - 'microsoft edge'
+  - 'edge browser'
+  - 'IE'
+  - 'Explorer'
+  - 'browser crashes'
+
+macos:
+  - 'macOS'
+  - 'mac OS'
+  - 'OS X'
+  - 'darwin'
+  - 'cocoa'
+  - 'Safari'
+  - 'Catalyst'
+  - 'Ventura'
+  - 'Sonoma'
+  - 'apple'
+
+linux:
+  - 'linux'
+  - 'ubuntu'
+  - 'debian'
+  - 'fedora'
+  - 'gtk'
+  - 'webkitgtk'
+  - 'webkit2gtk'
+  - 'gnome'
+  - 'x11'
+  - 'wayland'
+
+cli:
+  - 'cli'
+  - 'command line'
+  - 'wails doctor'
+  - 'wails init'
+  - 'wails build'
+  - 'wails dev'
+  - 'template'
+  - 'scaffolding'
+
+# Type labels
+bug:
+  - 'bug'
+  - 'crash'
+  - 'broken'
+  - 'failure'
+  - 'error'
+  - 'failed'
+  - 'panic'
+  - 'segfault'
+  - 'issue'
+  - 'not working'
+  - 'problem'
+
+enhancement:
+  - 'feature'
+  - 'enhancement'
+  - 'request'
+  - 'add'
+  - 'new'
+  - 'improve'
+  - 'functionality'
+  - 'support for'
+  - 'please add'
+  - 'would be nice'
+
+documentation:
+  - 'docs'
+  - 'documentation'
+  - 'readme'
+  - 'example'
+  - 'tutorial'
+  - 'guide'
+  - 'explanation'
+  - 'clarification'
+  - 'instructions'
+
+security:
+  - 'security'
+  - 'vulnerability'
+  - 'exploit'
+  - 'hack'
+  - 'CVE'
+  - 'secure'
+  - 'encryption'
+  - 'hardening'
+
+performance:
+  - 'performance'
+  - 'slow'
+  - 'speed'
+  - 'memory leak'
+  - 'cpu usage'
+  - 'high memory'
+  - 'lag'
+  - 'freeze'
+  - 'optimization'
+
+# Priority labels
+high-priority:
+  - 'urgent'
+  - 'critical'
+  - 'security'
+  - 'high priority'
+  - 'important'
+  - 'production'
+  - 'blocker'
+  - 'blocking'
+
+question:
+  - 'how to'
+  - 'how do i'
+  - 'can I'
+  - 'is it possible'
+  - 'question'
+  - 'help me'
+  - 'need help'
+  - 'assistance'
+  - 'confused'

.github/pull_request_template.md

@@ -1,9 +1,20 @@
 
 <!--
-READ CAREFULLY: Before submitting your PR, please ensure you have created an issue for your PR.
+
-It is essential that you do this so that we can discuss the proposed changes before you spend time on them.
+*********************************************************************
-If you do not create an issue, your PR may be rejected without review.
+*               PLEASE READ BEFORE SUBMITTING YOUR PR               *
-If a relevant issue already exists, please reference it in your PR by including `Fixes #<issue number>` in your PR description.
+*     YOUR PR MAY BE REJECTED IF IT DOES NOT FOLLOW THESE STEPS     *
+*********************************************************************
+
+- *DO NOT* submit bugs for a source install of v3, ONLY tagged versions, e.g. v3.0.0-alpha.11
+- *DO NOT* submit PRs for v3 alpha enhancements, unless you have opened a post on the discord channel.
+  All enhancements must be discussed first.
+  The feedback guide for v3 is here: https://v3alpha.wails.io/getting-started/feedback/
+
+- Before submitting your PR, please ensure you have created and linked the PR to an issue.
+- If a relevant issue already exists, please reference it in your PR by including `Fixes #<issue number>` in your PR description.
+- Please fill in the checklists.
+
 -->
 
 # Description
@@ -14,7 +25,7 @@ Fixes # (issue)
 
 ## Type of change
   
-Please delete options that are not relevant.
+Please select the option that is relevant.
 
 - [ ] Bug fix (non-breaking change which fixes an issue)
 - [ ] New feature (non-breaking change which adds functionality)
@@ -28,6 +39,8 @@ Please describe the tests that you ran to verify your changes. Provide instructi
 - [ ] Windows
 - [ ] macOS
 - [ ] Linux
+      
+If you checked Linux, please specify the distro and version.
   
 ## Test Configuration
 
@@ -35,7 +48,7 @@ Please paste the output of `wails doctor`. If you are unable to run this command
 
 # Checklist:
 
-- [ ] I have updated `website/src/pages/changelog.mdx` with details of this PR
+- [ ] I have updated `v3/UNRELEASED_CHANGELOG.md` with details of this PR
 - [ ] My code follows the general coding style of this project
 - [ ] I have performed a self-review of my own code
 - [ ] I have commented my code, particularly in hard-to-understand areas

.github/stale.yml

@@ -1,7 +1,7 @@
 # Number of days of inactivity before an issue becomes stale
-daysUntilStale: 30
+daysUntilStale: 45
 # Number of days of inactivity before a stale issue is closed
-daysUntilClose: 7
+daysUntilClose: 10
 # Issues with these labels will never be considered stale
 exemptLabels:
   - pinned
@@ -9,14 +9,28 @@ exemptLabels:
   - onhold
   - inprogress
   - "Selected For Development"
+  - bug
+  - enhancement
+  - v3-alpha
+  - high-priority
 # Label to use when marking an issue as stale
-staleLabel: "Wont Fix"
+staleLabel: "stale"
 # Comment to post when marking an issue as stale. Set to `false` to disable
 markComment: >
   This issue has been automatically marked as stale because it has not had
-  recent activity. It will be closed if no further activity occurs. Thank you
+  recent activity. It will be closed if no further activity occurs within the next 10 days. 
-  for your contributions.
+  
+  If this issue is still relevant, please add a comment to keep it open.
+  Thank you for your contributions.
 # Comment to post when closing a stale issue. Set to `false` to disable
-closeComment: false
+closeComment: >
+  This issue has been automatically closed due to lack of activity.
+  Please feel free to reopen it if it's still relevant.
 exemptMilestones: true
 exemptAssignees: true
+# Only mark issues (not PRs)
+only: issues
+# Exempt issues created before a certain date
+exemptCreatedBefore: "2024-01-01T00:00:00Z"
+# Starts checking issues only after the specified date
+startDate: "2025-06-01T00:00:00Z"

.github/workflows/auto-label-issues.yml

@@ -0,0 +1,33 @@
+name: Auto Label Issues
+
+on:
+  issues:
+    types: [opened, edited, reopened]
+  pull_request_target:
+    types: [opened, edited, reopened, synchronize]
+
+jobs:
+  auto-label:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      pull-requests: write
+      contents: read
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v3
+
+      - name: Label issues and PRs by content
+        uses: github/issue-labeler@v3.4
+        with:
+          repo-token: "${{ secrets.GITHUB_TOKEN }}"
+          configuration-path: .github/issue-labeler.yml
+          enable-versioned-regex: 0
+          include-title: 1
+
+      - name: Label issues and PRs by file paths
+        uses: actions/labeler@v4
+        with:
+          repo-token: "${{ secrets.GITHUB_TOKEN }}"
+          configuration-path: .github/file-labeler.yml
+          sync-labels: true

.github/workflows/automated-releases.yml

@@ -0,0 +1,373 @@
+name: Automated Nightly Releases
+
+on:
+  workflow_dispatch:
+    inputs:
+      force_release:
+        description: 'Force release even if no changes detected'
+        required: false
+        default: false
+        type: boolean
+      dry_run:
+        description: 'Run in dry-run mode (no actual releases)'
+        required: false
+        default: false
+        type: boolean
+  # schedule:
+    # Run at 2 AM UTC every day - DISABLED for safety until ready
+    # - cron: '0 2 * * *'
+
+env:
+  GO_VERSION: '1.24'
+
+jobs:
+  check-permissions:
+    name: Check Release Permissions
+    permissions: {}
+    runs-on: ubuntu-latest
+    outputs:
+      authorized: ${{ steps.check.outputs.authorized }}
+    steps:
+      - name: Check if user is authorized for releases
+        id: check
+        run: |
+          # Only allow specific users to trigger releases
+          AUTHORIZED_USERS="leaanthony"
+          
+          if [[ "$AUTHORIZED_USERS" == *"${{ github.actor }}"* ]]; then
+            echo "✅ User ${{ github.actor }} is authorized for releases"
+            echo "authorized=true" >> $GITHUB_OUTPUT
+          else
+            echo "❌ User ${{ github.actor }} is not authorized for releases"
+            echo "authorized=false" >> $GITHUB_OUTPUT
+          fi
+
+  detect-v2-changes:
+    name: Detect v2 Changes
+    runs-on: ubuntu-latest
+    needs: check-permissions
+    if: needs.check-permissions.outputs.authorized == 'true'
+    outputs:
+      has_changes: ${{ steps.changes.outputs.has_changes }}
+      commits_since_last: ${{ steps.changes.outputs.commits_since_last }}
+      last_release_tag: ${{ steps.changes.outputs.last_release_tag }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Check for v2 changes since last release
+        id: changes
+        run: |
+          echo "🔍 Checking for v2 changes since last release..."
+          
+          # Find the last v2 release tag
+          LAST_TAG=$(git tag -l "v2.*" --sort=-version:refname | head -n 1)
+          if [ -z "$LAST_TAG" ]; then
+            echo "No previous v2 tags found, assuming first release"
+            LAST_TAG=$(git rev-list --max-parents=0 HEAD)
+            echo "has_changes=true" >> $GITHUB_OUTPUT
+            echo "commits_since_last=999" >> $GITHUB_OUTPUT
+            echo "last_release_tag=none" >> $GITHUB_OUTPUT
+          else
+            echo "Last v2 release tag: $LAST_TAG"
+            echo "last_release_tag=$LAST_TAG" >> $GITHUB_OUTPUT
+            
+            # Count commits since last release affecting v2 or root files
+            COMMITS_COUNT=$(git rev-list --count ${LAST_TAG}..HEAD -- v2/ website/ README.md CHANGELOG.md || echo "0")
+            echo "Commits since last v2 release: $COMMITS_COUNT"
+            echo "commits_since_last=$COMMITS_COUNT" >> $GITHUB_OUTPUT
+            
+            if [ "$COMMITS_COUNT" -gt 0 ] || [ "${{ github.event.inputs.force_release }}" == "true" ]; then
+              echo "✅ Changes detected or forced release"
+              echo "has_changes=true" >> $GITHUB_OUTPUT
+            else
+              echo "ℹ️ No changes detected since last release"
+              echo "has_changes=false" >> $GITHUB_OUTPUT
+            fi
+          fi
+
+  detect-v3-changes:
+    name: Detect v3-alpha Changes  
+    runs-on: ubuntu-latest
+    needs: check-permissions
+    if: needs.check-permissions.outputs.authorized == 'true'
+    outputs:
+      has_changes: ${{ steps.changes.outputs.has_changes }}
+      commits_since_last: ${{ steps.changes.outputs.commits_since_last }}
+      last_release_tag: ${{ steps.changes.outputs.last_release_tag }}
+    steps:
+      - name: Checkout v3-alpha branch
+        uses: actions/checkout@v4
+        with:
+          ref: v3-alpha
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Check for v3-alpha changes since last release
+        id: changes
+        run: |
+          echo "🔍 Checking for v3-alpha changes since last release..."
+          
+          # Find the last v3 alpha release tag
+          LAST_TAG=$(git tag -l "v3.*-alpha.*" --sort=-version:refname | head -n 1)
+          if [ -z "$LAST_TAG" ]; then
+            echo "No previous v3-alpha tags found, assuming first release"
+            LAST_TAG=$(git rev-list --max-parents=0 HEAD)
+            echo "has_changes=true" >> $GITHUB_OUTPUT
+            echo "commits_since_last=999" >> $GITHUB_OUTPUT
+            echo "last_release_tag=none" >> $GITHUB_OUTPUT
+          else
+            echo "Last v3-alpha release tag: $LAST_TAG"
+            echo "last_release_tag=$LAST_TAG" >> $GITHUB_OUTPUT
+            
+            # Count commits since last release affecting v3 or docs
+            COMMITS_COUNT=$(git rev-list --count ${LAST_TAG}..HEAD -- v3/ docs/ || echo "0")
+            echo "Commits since last v3-alpha release: $COMMITS_COUNT"
+            echo "commits_since_last=$COMMITS_COUNT" >> $GITHUB_OUTPUT
+            
+            if [ "$COMMITS_COUNT" -gt 0 ] || [ "${{ github.event.inputs.force_release }}" == "true" ]; then
+              echo "✅ Changes detected or forced release"
+              echo "has_changes=true" >> $GITHUB_OUTPUT
+            else
+              echo "ℹ️ No changes detected since last release"
+              echo "has_changes=false" >> $GITHUB_OUTPUT
+            fi
+          fi
+
+  release-v2:
+    name: Create v2 Release
+    runs-on: ubuntu-latest
+    needs: [check-permissions, detect-v2-changes]
+    if: |
+      needs.check-permissions.outputs.authorized == 'true' &&
+      needs.detect-v2-changes.outputs.has_changes == 'true'
+    outputs:
+      version: ${{ steps.release.outputs.version }}
+      release_notes: ${{ steps.release.outputs.release_notes }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Go
+        uses: actions/setup-go@v4
+        with:
+          go-version: ${{ env.GO_VERSION }}
+
+      - name: Run v2 release script and extract notes
+        id: release
+        run: |
+          echo "🚀 Running v2 release script..."
+          cd v2/tools/release
+          
+          # Run release script and capture output
+          RELEASE_OUTPUT=$(go run release.go 2>&1)
+          echo "$RELEASE_OUTPUT"
+          
+          # Extract version from output or version file
+          NEW_VERSION=$(cat ../../cmd/wails/internal/version.txt)
+          echo "version=$NEW_VERSION" >> $GITHUB_OUTPUT
+          
+          # Extract release notes from delimited output
+          RELEASE_NOTES=$(echo "$RELEASE_OUTPUT" | sed -n '/=== RELEASE NOTES FOR/,/=== END RELEASE NOTES ===/p' | sed '1d;$d')
+          
+          # Save release notes to file for multiline output
+          echo "$RELEASE_NOTES" > ../../../release_notes_v2.md
+          
+          # Set output (escape for GitHub Actions)
+          {
+            echo "release_notes<<EOF"
+            echo "$RELEASE_NOTES"
+            echo "EOF"
+          } >> $GITHUB_OUTPUT
+          
+          echo "✅ v2 release script completed - version: $NEW_VERSION"
+
+      - name: Create v2 git tag and release
+        if: github.event.inputs.dry_run != 'true'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          VERSION="${{ steps.release.outputs.version }}"
+          echo "📝 Creating v2 release: $VERSION"
+          
+          # Configure git
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          
+          # Commit the changelog changes
+          git add website/src/pages/changelog.mdx v2/cmd/wails/internal/version.txt
+          git commit -m "chore: release $VERSION
+
+          Automated release created by GitHub Actions
+
+          🤖 Generated with [Claude Code](https://claude.ai/code)
+
+          Co-Authored-By: Claude <noreply@anthropic.com>"
+          
+          # Create and push tag
+          git tag -a "$VERSION" -m "Release $VERSION"
+          git push origin master
+          git push origin "$VERSION"
+          
+          # Create GitHub release with notes
+          gh release create "$VERSION" \
+            --title "Release $VERSION" \
+            --notes-file release_notes_v2.md \
+            --target master
+
+      - name: Log dry-run results for v2
+        if: github.event.inputs.dry_run == 'true'
+        run: |
+          echo "🧪 DRY RUN - Would have created v2 release:"
+          echo "Version: ${{ steps.release.outputs.version }}"
+          echo "Release Notes:"
+          cat release_notes_v2.md
+
+  release-v3:
+    name: Create v3-alpha Release
+    runs-on: ubuntu-latest
+    needs: [check-permissions, detect-v3-changes]
+    if: |
+      needs.check-permissions.outputs.authorized == 'true' &&
+      needs.detect-v3-changes.outputs.has_changes == 'true'
+    outputs:
+      version: ${{ steps.release.outputs.version }}
+      release_notes: ${{ steps.release.outputs.release_notes }}
+    steps:
+      - name: Checkout v3-alpha branch
+        uses: actions/checkout@v4
+        with:
+          ref: v3-alpha
+          fetch-depth: 0
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Setup Go
+        uses: actions/setup-go@v4
+        with:
+          go-version: ${{ env.GO_VERSION }}
+
+      - name: Run v3 release script and extract notes
+        id: release
+        run: |
+          echo "🚀 Running v3-alpha release script..."
+          cd v3/tasks/release
+          
+          # Run release script and capture output
+          RELEASE_OUTPUT=$(go run release.go 2>&1)
+          echo "$RELEASE_OUTPUT"
+          
+          # Extract version from output or version file
+          NEW_VERSION=$(cat ../../internal/version/version.txt)
+          echo "version=$NEW_VERSION" >> $GITHUB_OUTPUT
+          
+          # Extract release notes from delimited output
+          RELEASE_NOTES=$(echo "$RELEASE_OUTPUT" | sed -n '/=== RELEASE NOTES FOR/,/=== END RELEASE NOTES ===/p' | sed '1d;$d')
+          
+          # Save release notes to file for multiline output
+          echo "$RELEASE_NOTES" > ../../../release_notes_v3.md
+          
+          # Set output (escape for GitHub Actions)
+          {
+            echo "release_notes<<EOF"
+            echo "$RELEASE_NOTES"
+            echo "EOF"
+          } >> $GITHUB_OUTPUT
+          
+          echo "✅ v3-alpha release script completed - version: $NEW_VERSION"
+
+      - name: Create v3-alpha git tag and release
+        if: github.event.inputs.dry_run != 'true'
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          VERSION="${{ steps.release.outputs.version }}"
+          echo "📝 Creating v3-alpha release: $VERSION"
+          
+          # Configure git
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+          
+          # Commit the changelog changes
+          git add docs/src/content/docs/changelog.mdx v3/internal/version/version.txt
+          git commit -m "chore: release $VERSION
+
+          Automated v3-alpha release created by GitHub Actions
+
+          🤖 Generated with [Claude Code](https://claude.ai/code)
+
+          Co-Authored-By: Claude <noreply@anthropic.com>"
+          
+          # Create and push tag
+          git tag -a "$VERSION" -m "Release $VERSION"
+          git push origin v3-alpha
+          git push origin "$VERSION"
+          
+          # Create GitHub release with notes
+          gh release create "$VERSION" \
+            --title "Release $VERSION" \
+            --notes-file release_notes_v3.md \
+            --target v3-alpha \
+            --prerelease
+
+      - name: Log dry-run results for v3-alpha
+        if: github.event.inputs.dry_run == 'true'
+        run: |
+          echo "🧪 DRY RUN - Would have created v3-alpha release:"
+          echo "Version: ${{ steps.release.outputs.version }}"
+          echo "Release Notes:"
+          cat release_notes_v3.md
+
+  summary:
+    name: Release Summary
+    runs-on: ubuntu-latest
+    needs: [check-permissions, detect-v2-changes, detect-v3-changes, release-v2, release-v3]
+    if: always() && needs.check-permissions.outputs.authorized == 'true'
+    steps:
+      - name: Create release summary
+        run: |
+          echo "# 🚀 Automated Release Summary" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "**Repository**: ${{ github.repository }}" >> $GITHUB_STEP_SUMMARY
+          echo "**Triggered by**: ${{ github.actor }}" >> $GITHUB_STEP_SUMMARY
+          echo "**Dry Run Mode**: ${{ github.event.inputs.dry_run || 'false' }}" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          
+          # v2 Summary
+          echo "## v2 Release" >> $GITHUB_STEP_SUMMARY
+          if [ "${{ needs.detect-v2-changes.outputs.has_changes }}" == "true" ]; then
+            if [ "${{ needs.release-v2.result }}" == "success" ]; then
+              echo "✅ **v2 Release**: Created successfully" >> $GITHUB_STEP_SUMMARY
+              echo "  - Version: ${{ needs.release-v2.outputs.version }}" >> $GITHUB_STEP_SUMMARY
+              echo "  - Commits since last: ${{ needs.detect-v2-changes.outputs.commits_since_last }}" >> $GITHUB_STEP_SUMMARY
+            else
+              echo "❌ **v2 Release**: Failed" >> $GITHUB_STEP_SUMMARY
+            fi
+          else
+            echo "⏭️ **v2 Release**: Skipped (no changes)" >> $GITHUB_STEP_SUMMARY
+            echo "  - Commits since last: ${{ needs.detect-v2-changes.outputs.commits_since_last }}" >> $GITHUB_STEP_SUMMARY
+          fi
+          
+          # v3 Summary
+          echo "## v3-alpha Release" >> $GITHUB_STEP_SUMMARY
+          if [ "${{ needs.detect-v3-changes.outputs.has_changes }}" == "true" ]; then
+            if [ "${{ needs.release-v3.result }}" == "success" ]; then
+              echo "✅ **v3-alpha Release**: Created successfully" >> $GITHUB_STEP_SUMMARY
+              echo "  - Version: ${{ needs.release-v3.outputs.version }}" >> $GITHUB_STEP_SUMMARY
+              echo "  - Commits since last: ${{ needs.detect-v3-changes.outputs.commits_since_last }}" >> $GITHUB_STEP_SUMMARY
+            else
+              echo "❌ **v3-alpha Release**: Failed" >> $GITHUB_STEP_SUMMARY
+            fi
+          else
+            echo "⏭️ **v3-alpha Release**: Skipped (no changes)" >> $GITHUB_STEP_SUMMARY
+            echo "  - Commits since last: ${{ needs.detect-v3-changes.outputs.commits_since_last }}" >> $GITHUB_STEP_SUMMARY
+          fi
+          
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "---" >> $GITHUB_STEP_SUMMARY
+          echo "🤖 **Automated Release System** | Generated with [Claude Code](https://claude.ai/code)" >> $GITHUB_STEP_SUMMARY

.github/workflows/build-and-test-v3.yml

@@ -0,0 +1,282 @@
+name: Build + Test v3
+
+on:
+  pull_request:
+    types: [opened, synchronize, reopened, ready_for_review]
+    branches:
+      - v3-alpha
+  pull_request_review:
+    types: [submitted]
+    branches:
+      - v3-alpha
+
+jobs:
+  check_approval:
+    name: Check PR Approval
+    runs-on: ubuntu-latest
+    if: github.base_ref == 'v3-alpha'
+    outputs:
+      approved: ${{ steps.check.outputs.approved }}
+    steps:
+      - name: Check if PR is approved
+        id: check
+        run: |
+          if [[ "${{ github.event.review.state }}" == "approved" || "${{ github.event.pull_request.approved }}" == "true" ]]; then
+            echo "approved=true" >> $GITHUB_OUTPUT
+          else
+            echo "approved=false" >> $GITHUB_OUTPUT
+          fi
+
+  test_js:
+    name: Run JS Tests
+    needs: check_approval
+    runs-on: ubuntu-latest
+    if: github.base_ref == 'v3-alpha'
+    strategy:
+      matrix:
+        node-version: [20.x]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+
+      - name: Install Task
+        uses: arduino/setup-task@v2
+        with:
+          version: 3.x
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Install dependencies
+        working-directory: v3/internal/runtime/desktop/@wailsio/runtime
+        run: |
+          npm ci
+          npx --yes esbuild@latest --version
+
+      - name: Clean build artifacts
+        working-directory: v3/internal/runtime/desktop/@wailsio/runtime
+        run: npm run clean
+
+      - name: Type-check runtime
+        working-directory: v3
+        run: task runtime:check
+
+      - name: Test runtime
+        working-directory: v3
+        run: task runtime:test
+
+      - name: Check that the bundled runtime builds
+        working-directory: v3
+        run: task runtime:build
+
+      - name: Check that the npm package builds
+        working-directory: v3/internal/runtime/desktop/@wailsio/runtime
+        run: npm run build
+
+      - name: Pack runtime for template tests
+        working-directory: v3/internal/runtime/desktop/@wailsio/runtime
+        run: npm pack
+
+      - name: Store runtime build artifacts
+        uses: actions/upload-artifact@v4
+        with:
+          name: runtime-build-artifacts
+          path: |
+            v3/internal/runtime/desktop/@wailsio/runtime/dist/
+            v3/internal/runtime/desktop/@wailsio/runtime/types/
+            v3/internal/runtime/desktop/@wailsio/runtime/tsconfig.tsbuildinfo
+
+      - name: Store runtime package
+        uses: actions/upload-artifact@v4
+        with:
+          name: runtime-package
+          path: v3/internal/runtime/desktop/@wailsio/runtime/*.tgz
+
+  test_go:
+    name: Run Go Tests v3
+    needs: [check_approval, test_js]
+    runs-on: ${{ matrix.os }}
+    if: github.base_ref == 'v3-alpha'
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [windows-latest, ubuntu-latest, macos-latest]
+        go-version: [1.24]
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Install linux dependencies
+        uses: awalsh128/cache-apt-pkgs-action@latest
+        if: matrix.os == 'ubuntu-latest'
+        with:
+          packages: libgtk-3-dev libwebkit2gtk-4.1-dev build-essential pkg-config xvfb x11-xserver-utils at-spi2-core xdg-desktop-portal-gtk
+          version: 1.0
+
+      - name: Setup Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: ${{ matrix.go-version }}
+          cache: true
+          cache-dependency-path: "v3/go.sum"
+
+      - name: Install Task
+        uses: arduino/setup-task@v2
+        with:
+          version: 3.x
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Retrieve runtime build artifacts
+        uses: actions/download-artifact@v4
+        with:
+          name: runtime-build-artifacts
+          path: v3/internal/runtime/desktop/@wailsio/runtime/
+
+      - name: Build Examples
+        working-directory: v3
+        run: |
+          echo "Starting example compilation tests..."
+          task test:examples
+          echo "Example compilation tests completed successfully"
+
+      - name: Run tests (mac)
+        if: matrix.os == 'macos-latest'
+        env:
+          CGO_LDFLAGS: -framework UniformTypeIdentifiers -mmacosx-version-min=10.13
+        working-directory: v3
+        run: go test -v ./...
+
+      - name: Run tests (windows)
+        if: matrix.os == 'windows-latest'
+        working-directory: v3
+        run: go test -v ./...
+
+      - name: Run tests (ubuntu)
+        if: matrix.os == 'ubuntu-latest'
+        working-directory: v3
+        run: >
+          xvfb-run --auto-servernum
+          sh -c '
+          dbus-update-activation-environment --systemd --all &&
+          go test -v ./...
+          '
+
+      - name: Typecheck binding generator output
+        working-directory: v3
+        run: task generator:test:check
+
+  cleanup:
+    name: Cleanup build artifacts
+    if: always()
+    needs: [test_js, test_go, test_templates]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: geekyeggo/delete-artifact@v5
+        with:
+          name: |
+            runtime-build-artifacts
+            runtime-package
+          failOnError: false
+
+  test_templates:
+    name: Test Templates
+    needs: [test_js, test_go]
+    runs-on: ${{ matrix.os }}
+    if: github.base_ref == 'v3-alpha'
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        template:
+          - svelte
+          - svelte-ts
+          - vue
+          - vue-ts
+          - react
+          - react-ts
+          - preact
+          - preact-ts
+          - lit
+          - lit-ts
+          - vanilla
+          - vanilla-ts
+        go-version: [1.24]
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Install linux dependencies
+        uses: awalsh128/cache-apt-pkgs-action@latest
+        if: matrix.os == 'ubuntu-latest'
+        with:
+          packages: libgtk-3-dev libwebkit2gtk-4.1-dev build-essential pkg-config
+          version: 1.0
+
+      - name: Setup Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: ${{ matrix.go-version }}
+          cache: true
+          cache-dependency-path: "v3/go.sum"
+
+      - name: Install Task
+        uses: arduino/setup-task@v2
+        with:
+          version: 3.x
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Build Wails3 CLI
+        working-directory: v3
+        run: |
+          task install
+          wails3 doctor
+
+      - name: Download runtime package
+        uses: actions/download-artifact@v4
+        with:
+          name: runtime-package
+          path: wails-runtime-temp
+
+      - name: Generate template '${{ matrix.template }}'
+        shell: bash
+        run: |
+          # Get absolute path - use pwd -W on Windows for native paths, pwd elsewhere
+          if [[ "$RUNNER_OS" == "Windows" ]]; then
+            RUNTIME_TGZ="$(cd wails-runtime-temp && pwd -W)/$(ls wails-runtime-temp/*.tgz | xargs basename)"
+          else
+            RUNTIME_TGZ="$(cd wails-runtime-temp && pwd)/$(ls wails-runtime-temp/*.tgz | xargs basename)"
+          fi
+          mkdir -p ./test-${{ matrix.template }}
+          cd ./test-${{ matrix.template }}
+          wails3 init -n ${{ matrix.template }} -t ${{ matrix.template }}
+          cd ${{ matrix.template }}/frontend
+          # Replace @wailsio/runtime version with local tarball
+          npm pkg set dependencies.@wailsio/runtime="file://$RUNTIME_TGZ"
+          cd ..
+          wails3 build
+
+  build_results:
+    if: ${{ always() }}
+    runs-on: ubuntu-latest
+    name: v3 Build Results
+    needs: [test_go, test_js, test_templates]
+    steps:
+      - run: |
+          go_result="${{ needs.test_go.result }}"
+          js_result="${{ needs.test_js.result }}"
+          templates_result="${{ needs.test_templates.result }}"
+          
+          if [[ $go_result == "success" || $go_result == "skipped" ]] && \
+             [[ $js_result == "success" || $js_result == "skipped" ]] && \
+             [[ $templates_result == "success" || $templates_result == "skipped" ]]; then
+            echo "All required jobs succeeded or were skipped"
+            exit 0
+          else
+            echo "One or more required jobs failed"
+            exit 1
+          fi

.github/workflows/changelog-validation-v3.yml

@@ -0,0 +1,74 @@
+name: Changelog Validation (v3)
+
+on:
+  pull_request:
+    branches: [ v3-alpha ]
+  workflow_dispatch:
+    inputs:
+      pr_number:
+        description: 'PR number to validate (for manual testing)'
+        required: true
+        type: string
+
+jobs:
+  validate-changelog:
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request' || github.event.inputs.pr_number
+    
+    permissions:
+      contents: write
+      pull-requests: write
+      
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      with:
+        ref: ${{ github.event.pull_request.head.sha || format('refs/pull/{0}/head', github.event.inputs.pr_number) }}
+        fetch-depth: 0
+        token: ${{ secrets.GITHUB_TOKEN }}
+        
+    - name: Setup Go
+      uses: actions/setup-go@v4
+      with:
+        go-version: '1.23'
+        
+    - name: Get PR information
+      id: pr_info
+      run: |
+        if [ "${{ github.event_name }}" = "pull_request" ]; then
+          echo "pr_number=${{ github.event.pull_request.number }}" >> $GITHUB_OUTPUT
+          echo "base_ref=${{ github.event.pull_request.base.ref }}" >> $GITHUB_OUTPUT
+        else
+          echo "pr_number=${{ github.event.inputs.pr_number }}" >> $GITHUB_OUTPUT
+          echo "base_ref=v3-alpha" >> $GITHUB_OUTPUT
+        fi
+        
+    - name: Check if changelog was modified
+      id: changelog_check
+      run: |
+        git fetch origin ${{ steps.pr_info.outputs.base_ref }}
+        if git diff --name-only origin/${{ steps.pr_info.outputs.base_ref }}..HEAD | grep -q "v3/UNRELEASED_CHANGELOG.md"; then
+          echo "changelog_modified=true" >> $GITHUB_OUTPUT
+          echo "✅ UNRELEASED_CHANGELOG.md was modified in this PR"
+        else
+          echo "changelog_modified=false" >> $GITHUB_OUTPUT
+          echo "⚠️ UNRELEASED_CHANGELOG.md was not modified"
+        fi
+        
+    - name: Comment on PR about missing changelog
+      if: steps.changelog_check.outputs.changelog_modified == 'false' && github.event_name == 'pull_request'
+      uses: actions/github-script@v7
+      with:
+        script: |
+          const author = context.payload.pull_request.user.login;
+          const message = '## ⚠️ Missing Changelog Update\n\n' +
+            `Hi @${author}, please update \`v3/UNRELEASED_CHANGELOG.md\` with a description of your changes.\n\n` +
+            'This helps us keep track of changes for the next release.';
+          
+          await github.rest.issues.createComment({
+            issue_number: ${{ steps.pr_info.outputs.pr_number }},
+            owner: context.repo.owner,
+            repo: context.repo.repo,
+            body: message
+          });
+        

.github/workflows/generate-sponsor-image.yml

@@ -29,7 +29,12 @@ jobs:
         with:
           commit-message: "chore: update sponsors.svg"
           add-paths: "website/static/img/sponsors.svg"
-          title: Update Sponsor Image
+          title: "chore: update sponsors.svg"
-          body: Generated new image
+          body: |
+            Auto-generated by the sponsor image workflow
+            
+            [skip ci] [skip actions]
           branch: update-sponsors
+          base: master
           delete-branch: true
+          draft: false

.github/workflows/issue-triage-automation.yml

@@ -0,0 +1,77 @@
+name: Issue Triage Automation
+
+on:
+  issues:
+    types: [opened, reopened, labeled, unlabeled]
+
+jobs:
+  triage:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      contents: read
+    steps:
+      # Request more info for unclear bug reports
+      - name: Request more info
+        uses: actions/github-script@v6
+        if: |
+          contains(github.event.issue.labels.*.name, 'bug') &&
+          !contains(github.event.issue.body, 'wails doctor') &&
+          !contains(github.event.issue.body, 'reproduction')
+        with:
+          script: |
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: `👋 Thanks for reporting this issue! To help us investigate, could you please:
+
+              1. Add the output of \`wails doctor\` if not already included
+              2. Provide clear steps to reproduce the issue
+              3. If possible, create a minimal reproduction of the issue
+              
+              This will help us resolve your issue much faster. Thank you!`
+            });
+            github.rest.issues.addLabels({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              labels: ['awaiting feedback']
+            });
+
+      # Prioritize security issues
+      - name: Prioritize security issues
+        uses: actions/github-script@v6
+        if: contains(github.event.issue.labels.*.name, 'security')
+        with:
+          script: |
+            github.rest.issues.addLabels({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              labels: ['high-priority']
+            });
+
+      # Tag version-specific issues for project boards
+      - name: Add to v2 project
+        uses: actions/github-script@v6
+        if: |
+          contains(github.event.issue.labels.*.name, 'v2-only') &&
+          !contains(github.event.issue.labels.*.name, 'v3-alpha')
+        with:
+          script: |
+            // Replace PROJECT_ID with your actual GitHub project ID
+            // This is a placeholder as the actual implementation would require 
+            // GraphQL API calls to add to a project board
+            console.log('Would add to v2 project board');
+
+      # Tag version-specific issues for project boards
+      - name: Add to v3 project
+        uses: actions/github-script@v6
+        if: contains(github.event.issue.labels.*.name, 'v3-alpha')
+        with:
+          script: |
+            // Replace PROJECT_ID with your actual GitHub project ID
+            // This is a placeholder as the actual implementation would require 
+            // GraphQL API calls to add to a project board
+            console.log('Would add to v3 project board');

.github/workflows/nightly-release-v3.yml

@@ -0,0 +1,210 @@
+name: Nightly Release v3-alpha
+
+on:
+  schedule:
+    - cron: '0 2 * * *'  # 2 AM UTC daily
+  workflow_dispatch:
+    inputs:
+      force_release:
+        description: 'Force release even if no changes detected'
+        required: false
+        default: false
+        type: boolean
+      dry_run:
+        description: 'Run in dry-run mode (no actual release)'
+        required: false
+        default: true
+        type: boolean
+
+jobs:
+  nightly-release:
+    runs-on: ubuntu-latest
+    
+    permissions:
+      contents: write
+      pull-requests: read
+      actions: write
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+      with:
+        ref: v3-alpha
+        fetch-depth: 0
+        token: ${{ secrets.WAILS_REPO_TOKEN || github.token }}
+    
+    - name: Setup Go
+      uses: actions/setup-go@v4
+      with:
+        go-version: '1.24'
+        cache: true
+        cache-dependency-path: 'v3/go.sum'
+    
+    - name: Install Task
+      uses: arduino/setup-task@v2
+      with:
+        version: 3.x
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+    
+    - name: Setup Git
+      run: |
+        git config --global user.name "github-actions[bot]"
+        git config --global user.email "github-actions[bot]@users.noreply.github.com"
+        
+        # Configure git to use the token for authentication
+        git config --global url."https://x-access-token:${{ secrets.WAILS_REPO_TOKEN || github.token }}@github.com/".insteadOf "https://github.com/"
+    
+    - name: Check for existing release tag
+      id: check_tag
+      run: |
+        if git describe --tags --exact-match HEAD 2>/dev/null; then
+          echo "has_tag=true" >> $GITHUB_OUTPUT
+          echo "tag=$(git describe --tags --exact-match HEAD)" >> $GITHUB_OUTPUT
+        else
+          echo "has_tag=false" >> $GITHUB_OUTPUT
+          echo "tag=" >> $GITHUB_OUTPUT
+        fi
+    
+    - name: Check for unreleased changelog content
+      id: changelog_check
+      run: |
+        echo "🔍 Checking UNRELEASED_CHANGELOG.md for content..."
+        
+        # Run the release script in check mode to see if there's content
+        cd v3/tasks/release
+        
+        # Use the release script itself to check for content
+        if go run release.go --check-only 2>/dev/null; then
+          echo "has_unreleased_content=true" >> $GITHUB_OUTPUT
+          echo "✅ Found unreleased changelog content"
+        else
+          echo "has_unreleased_content=false" >> $GITHUB_OUTPUT
+          echo "ℹ️  No unreleased changelog content found"
+        fi
+
+    - name: Quick change detection and early exit
+      id: quick_check
+      run: |
+        echo "🔍 Quick check for changes to determine if we should continue..."
+        
+        # First check if we have unreleased changelog content
+        if [ "${{ steps.changelog_check.outputs.has_unreleased_content }}" == "true" ]; then
+          echo "✅ Found unreleased changelog content, proceeding with release"
+          echo "has_changes=true" >> $GITHUB_OUTPUT
+          echo "should_continue=true" >> $GITHUB_OUTPUT
+          echo "reason=Found unreleased changelog content" >> $GITHUB_OUTPUT
+          exit 0
+        fi
+        
+        # If no unreleased changelog content, check for git changes as fallback
+        echo "No unreleased changelog content found, checking for git changes..."
+        
+        # Check if current commit has a release tag
+        if git describe --tags --exact-match HEAD 2>/dev/null; then
+          CURRENT_TAG=$(git describe --tags --exact-match HEAD)
+          echo "Current commit has release tag: $CURRENT_TAG"
+          
+          # For tagged commits, check if there are changes since the tag
+          COMMIT_COUNT=$(git rev-list ${CURRENT_TAG}..HEAD --count)
+          if [ "$COMMIT_COUNT" -eq 0 ]; then
+            echo "has_changes=false" >> $GITHUB_OUTPUT
+            echo "should_continue=false" >> $GITHUB_OUTPUT
+            echo "reason=No changes since existing tag $CURRENT_TAG and no unreleased changelog content" >> $GITHUB_OUTPUT
+          else
+            echo "has_changes=true" >> $GITHUB_OUTPUT
+            echo "should_continue=true" >> $GITHUB_OUTPUT
+          fi
+        else
+          # No current tag, check against latest release
+          LATEST_TAG=$(git tag --list "v3.0.0-alpha.*" | sort -V | tail -1)
+          if [ -z "$LATEST_TAG" ]; then
+            echo "No previous release found, proceeding with release"
+            echo "has_changes=true" >> $GITHUB_OUTPUT
+            echo "should_continue=true" >> $GITHUB_OUTPUT
+          else
+            COMMIT_COUNT=$(git rev-list ${LATEST_TAG}..HEAD --count)
+            if [ "$COMMIT_COUNT" -gt 0 ]; then
+              echo "Found $COMMIT_COUNT commits since $LATEST_TAG"
+              echo "has_changes=true" >> $GITHUB_OUTPUT
+              echo "should_continue=true" >> $GITHUB_OUTPUT
+            else
+              echo "has_changes=false" >> $GITHUB_OUTPUT
+              echo "should_continue=false" >> $GITHUB_OUTPUT
+              echo "reason=No changes since latest release $LATEST_TAG and no unreleased changelog content" >> $GITHUB_OUTPUT
+            fi
+          fi
+        fi
+    
+    - name: Early exit - No changes detected
+      if: |
+        steps.quick_check.outputs.should_continue == 'false' && 
+        github.event.inputs.force_release != 'true'
+      run: |
+        echo "🛑 EARLY EXIT: ${{ steps.quick_check.outputs.reason }}"
+        echo ""
+        echo "ℹ️  No changes detected since last release and force_release is not enabled."
+        echo "   Workflow will exit early to save resources."
+        echo ""
+        echo "   To force a release anyway, run this workflow with 'force_release=true'"
+        echo ""
+        echo "## 🛑 Early Exit Summary" >> $GITHUB_STEP_SUMMARY
+        echo "**Reason:** ${{ steps.quick_check.outputs.reason }}" >> $GITHUB_STEP_SUMMARY
+        echo "**Action:** Workflow exited early to save resources" >> $GITHUB_STEP_SUMMARY
+        echo "**Force Release:** Set 'force_release=true' to override this behavior" >> $GITHUB_STEP_SUMMARY
+        exit 0
+    
+    - name: Continue with release process
+      if: |
+        steps.quick_check.outputs.should_continue == 'true' || 
+        github.event.inputs.force_release == 'true'
+      run: |
+        echo "✅ Proceeding with release process..."
+        if [ "${{ github.event.inputs.force_release }}" == "true" ]; then
+          echo "🔨 FORCE RELEASE: Overriding change detection"
+        fi
+    
+    - name: Run release script
+      id: release
+      if: |
+        steps.quick_check.outputs.should_continue == 'true' || 
+        github.event.inputs.force_release == 'true'
+      env:
+        WAILS_REPO_TOKEN: ${{ secrets.WAILS_REPO_TOKEN || github.token }}
+        GITHUB_TOKEN: ${{ secrets.WAILS_REPO_TOKEN || github.token }}
+      run: |
+        cd v3/tasks/release
+        ARGS=()
+        if [ "${{ github.event.inputs.dry_run }}" == "true" ]; then
+          ARGS+=(--dry-run)
+        fi
+        go run release.go "${ARGS[@]}"
+
+    - name: Summary
+      if: always()
+      run: |
+        if [ "${{ github.event.inputs.dry_run }}" == "true" ]; then
+          echo "## 🧪 DRY RUN Release Summary" >> $GITHUB_STEP_SUMMARY
+        else
+          echo "## 🚀 Nightly Release Summary" >> $GITHUB_STEP_SUMMARY
+        fi
+        echo "================================" >> $GITHUB_STEP_SUMMARY
+
+        if [ -n "${{ steps.release.outputs.release_version }}" ]; then
+          echo "- **Version:** ${{ steps.release.outputs.release_version }}" >> $GITHUB_STEP_SUMMARY
+          echo "- **Tag:** ${{ steps.release.outputs.release_tag }}" >> $GITHUB_STEP_SUMMARY
+          echo "- **Status:** ${{ steps.release.outcome == 'success' && '✅ Success' || '⚠️ Failed' }}" >> $GITHUB_STEP_SUMMARY
+          echo "- **Mode:** ${{ steps.release.outputs.release_dry_run == 'true' && '🧪 Dry Run' || '🚀 Live release' }}" >> $GITHUB_STEP_SUMMARY
+          if [ -n "${{ steps.release.outputs.release_url }}" ]; then
+            echo "- **Release URL:** ${{ steps.release.outputs.release_url }}" >> $GITHUB_STEP_SUMMARY
+          fi
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "### Changelog" >> $GITHUB_STEP_SUMMARY
+          if [ "${{ steps.changelog_check.outputs.has_unreleased_content }}" == "true" ]; then
+            echo "✅ Unreleased changelog processed and reset." >> $GITHUB_STEP_SUMMARY
+          else
+            echo "ℹ️ No unreleased changelog content detected." >> $GITHUB_STEP_SUMMARY
+          fi
+        else
+          echo "- Release script did not run (skipped or failed before execution)." >> $GITHUB_STEP_SUMMARY
+        fi
+    

.github/workflows/pr-master.yml

@@ -1,20 +1,23 @@
-name: PR Checks
+name: PR Checks (master)
 
 on:
   pull_request:
+    branches:
+      - master
   pull_request_review:
     types: [submitted]
-
+    branches:
+      - master
 jobs:
   check_docs:
     name: Check Docs
-    if: ${{github.repository == 'wailsapp/wails' && contains(github.head_ref,'feature/')}}
+    if: ${{github.repository == 'wailsapp/wails' && github.base_ref == 'master'}}
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v3
 
       - name: Verify Changed files
-        uses: tj-actions/verify-changed-files@v17
+        uses: step-security/changed-files@3dbe17c78367e7d60f00d78ae6781a35be47b4a1 # v45.0.1
         id: verify-changed-files
         with:
           files: |
@@ -26,47 +29,28 @@ jobs:
         run: |
           echo "::warning::Feature branch does not contain any changes to the website."
 
-#  lint_go:
-#    name: Run Go Linters
-#    runs-on: ubuntu-latest
-#    steps:
-#      - name: Checkout code
-#        uses: actions/checkout@v4
-#
-#      - name: Setup Go
-#        uses: actions/setup-go@v4
-#        with:
-#          go-version: "1.21"
-#
-#      - name: Update go modules
-#        working-directory: ./v2
-#        run: go mod tidy
-#
-#      - name: Run Linter
-#        uses: golangci/golangci-lint-action@v3
-#        with:
-#          version: v1.54
-#          working-directory: ./v2
-#          args: --timeout=10m0s --config ./.golangci.yml
-
   test_go:
     name: Run Go Tests
     runs-on: ${{ matrix.os }}
-    if: github.event.review.state == 'approved'
+    if: >
+      github.event.review.state == 'approved' && 
+      github.repository == 'wailsapp/wails' && 
+      github.base_ref == 'master' &&
+      github.event.pull_request.head.ref != 'update-sponsors'
     strategy:
       matrix:
         os: [ubuntu-22.04, windows-latest, macos-latest, ubuntu-24.04]
-        go-version: ['1.21']
+        go-version: ['1.23']
 
     steps:
       - name: Checkout code
         uses: actions/checkout@v3
 
-      - name: Install linux dependencies ( 22.04 )
+      - name: Install linux dependencies (22.04)
         if: matrix.os == 'ubuntu-22.04'
         run: sudo apt-get update -y && sudo apt-get install -y libgtk-3-dev libwebkit2gtk-4.0-dev build-essential pkg-config
 
-      - name: Install linux dependencies ( 24.04 )
+      - name: Install linux dependencies (24.04)
         if: matrix.os == 'ubuntu-24.04'
         run: sudo apt-get update -y && sudo apt-get install -y libgtk-3-dev libwebkit2gtk-4.1-dev build-essential pkg-config
 

.github/workflows/publish-npm.yml

@@ -0,0 +1,119 @@
+on:
+  push:
+    branches: ['v3-alpha']
+  workflow_dispatch:
+
+concurrency:
+  group: publish-npm-v3
+  cancel-in-progress: true
+
+jobs:
+  detect:
+    name: Detect committed changes
+    if: github.event_name != 'workflow_dispatch'
+    outputs:
+      changed: ${{ steps.package-json-changes.outputs.any_modified == 'true' || steps.source-changes.outputs.any_modified == 'true' }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.sha }}
+          persist-credentials: 'true'
+
+      - name: Detect committed package.json changes
+        id: package-json-changes
+        uses: step-security/changed-files@3dbe17c78367e7d60f00d78ae6781a35be47b4a1 # v45.0.1
+        with:
+          files: |
+            v3/internal/runtime/desktop/@wailsio/runtime/package.json
+            v3/internal/runtime/desktop/@wailsio/runtime/package-lock.json
+
+      - name: Detect committed source changes
+        if: >-
+          steps.package-json-changes.outputs.any_modified != 'true'
+        id: source-changes
+        uses: step-security/changed-files@3dbe17c78367e7d60f00d78ae6781a35be47b4a1 # v45.0.1
+        with:
+          files: |
+            v3/internal/runtime/Taskfile.yaml
+            v3/internal/runtime/desktop/@wailsio/compiled/main.js
+            v3/internal/runtime/desktop/@wailsio/runtime/tsconfig.json
+            v3/internal/runtime/desktop/@wailsio/runtime/src/**
+            v3/pkg/events/events.txt
+            v3/tasks/events/**
+
+  rebuild_and_publish:
+    name: Rebuild and publish
+    needs: [detect]
+    if: >-
+      !failure() && !cancelled()
+      && (github.event_name == 'workflow_dispatch' || needs.detect.outputs.changed == 'true')
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      actions: read
+      pull-requests: read
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          ref: 'v3-alpha'
+          token: ${{ secrets.WAILS_REPO_TOKEN || github.token }}
+
+      - name: Configure git
+        run: |
+          git config --global user.email "github-actions@github.com"
+          git config --global user.name "GitHub Actions"
+          git config --global url."https://x-access-token:${{ secrets.WAILS_REPO_TOKEN || github.token }}@github.com/".insteadOf "https://github.com/"
+
+      - name: Install Task
+        uses: arduino/setup-task@v2
+        with:
+          version: 3.x
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Use Node.js 20
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Install dependencies
+        working-directory: v3/internal/runtime/desktop/@wailsio/runtime
+        run: |
+          npm ci
+          npx --yes esbuild@latest --version
+
+      - name: Clean build artifacts
+        working-directory: v3/internal/runtime/desktop/@wailsio/runtime
+        run: npm run clean
+
+      - name: Build bundled runtime
+        working-directory: v3
+        run: task runtime:build
+
+      - name: Test+Build npm package
+        working-directory: v3/internal/runtime/desktop/@wailsio/runtime
+        run: |
+          npm test
+          npm run build
+
+      - name: Bump version
+        id: bump-version
+        working-directory: v3/internal/runtime/desktop/@wailsio/runtime
+        run: |
+          echo "version=$(npm --no-git-tag-version --force version prerelease)" >> "$GITHUB_OUTPUT"
+
+      - name: Commit changes
+        run: |
+          git add .
+          git commit -m "[skip ci] Publish @wailsio/runtime ${{ steps.bump-version.outputs.version }}"
+          git push
+
+      - name: Publish npm package
+        uses: JS-DevTools/npm-publish@v3
+        with:
+          package: v3/internal/runtime/desktop/@wailsio/runtime
+          access: public
+          token: ${{ secrets.NPM_TOKEN }}

.github/workflows/semgrep.yml

@@ -5,6 +5,7 @@ on:
     branches:
     - main
     - master
+    - v3-alpha
     paths:
     - .github/workflows/semgrep.yml
   schedule:
@@ -14,7 +15,7 @@ name: Semgrep
 jobs:
   semgrep:
     name: semgrep/ci
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-24.04
     env:
       SEMGREP_APP_TOKEN: ${{ secrets.SEMGREP_APP_TOKEN }}
     container:

.github/workflows/stale-issues.yml

@@ -0,0 +1,57 @@
+name: Mark and Close Stale Issues
+
+on:
+  schedule:
+    - cron: '0 1 * * *'  # Run at 1 AM UTC every day
+  workflow_dispatch:  # Allow manual triggering
+
+jobs:
+  stale:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+      pull-requests: write
+    
+    steps:
+    - uses: actions/stale@v9
+      with:
+        # General settings
+        repo-token: ${{ secrets.GITHUB_TOKEN }}
+        days-before-stale: 45
+        days-before-close: 10
+        stale-issue-label: 'stale'
+        operations-per-run: 250  # Increased from 50 to 250
+        
+        # Issue specific settings
+        stale-issue-message: |
+          This issue has been automatically marked as stale because it has not had recent activity.
+          It will be closed if no further activity occurs within the next 10 days.
+          
+          If this issue is still relevant, please add a comment to keep it open.
+          Thank you for your contributions.
+        
+        close-issue-message: |
+          This issue has been automatically closed due to lack of activity.
+          Please feel free to reopen it if it's still relevant.
+        
+        # PR specific settings - We will not mark PRs as stale
+        days-before-pr-stale: -1  # Disable PR staling
+        days-before-pr-close: -1  # Disable PR closing
+        
+        # Exemptions
+        exempt-issue-labels: 'pinned,security,onhold,inprogress,Selected For Development,bug,enhancement,v3-alpha,high-priority'
+        exempt-all-issue-milestones: true
+        exempt-all-issue-assignees: true
+        
+        # Protection for existing issues
+        exempt-issue-created-before: '2024-01-01T00:00:00Z'
+        start-date: '2025-06-01T00:00:00Z'  # Don't start checking until June 1, 2025
+        
+        # Only process issues, not PRs
+        only-labels: ''
+        any-of-labels: ''
+        remove-stale-when-updated: true
+        
+        # Debug options
+        debug-only: false  # Set to true to test without actually marking issues
+        ascending: true    # Process older issues first

.github/workflows/test-nightly-releases.yml

@@ -0,0 +1,218 @@
+name: Test Nightly Releases (Dry Run)
+permissions:
+  contents: read
+
+on:
+  workflow_dispatch:
+    inputs:
+      dry_run:
+        description: 'Run in dry-run mode (no actual releases)'
+        required: false
+        default: true
+        type: boolean
+      test_branch:
+        description: 'Branch to test against'
+        required: false
+        default: 'master'
+        type: string
+
+env:
+  GO_VERSION: '1.24'
+
+jobs:
+  test-permissions:
+    name: Test Release Permissions
+    runs-on: ubuntu-latest
+    outputs:
+      authorized: ${{ steps.check.outputs.authorized }}
+    steps:
+      - name: Check if user is authorized
+        id: check
+        run: |
+          # Test authorization logic
+          AUTHORIZED_USERS="leaanthony"
+          
+          if [[ "$AUTHORIZED_USERS" == *"${{ github.actor }}"* ]]; then
+            echo "✅ User ${{ github.actor }} is authorized"
+            echo "authorized=true" >> $GITHUB_OUTPUT
+          else
+            echo "❌ User ${{ github.actor }} is not authorized"
+            echo "authorized=false" >> $GITHUB_OUTPUT
+          fi
+
+  test-changelog-extraction:
+    name: Test Changelog Extraction
+    runs-on: ubuntu-latest
+    needs: test-permissions
+    if: needs.test-permissions.outputs.authorized == 'true'
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          ref: ${{ github.event.inputs.test_branch }}
+          fetch-depth: 0
+
+      - name: Test v2 changelog extraction
+        run: |
+          echo "🧪 Testing v2 changelog extraction..."
+          CHANGELOG_FILE="website/src/pages/changelog.mdx"
+          
+          if [ ! -f "$CHANGELOG_FILE" ]; then
+            echo "❌ v2 changelog file not found"
+            exit 1
+          fi
+          
+          # Extract unreleased section
+          awk '
+          /^## \[Unreleased\]/ { found=1; next }
+          found && /^## / { exit }
+          found && !/^$/ { print }
+          ' $CHANGELOG_FILE > v2_release_notes.md
+          
+          echo "📝 v2 changelog content (first 10 lines):"
+          head -10 v2_release_notes.md || echo "No content found"
+          echo "Total lines: $(wc -l < v2_release_notes.md)"
+
+      - name: Test v3 changelog extraction (if accessible)
+        run: |
+          echo "🧪 Testing v3 changelog extraction..."
+          
+          if git show v3-alpha:docs/src/content/docs/changelog.mdx > /dev/null 2>&1; then
+            echo "✅ v3 changelog accessible"
+            
+            git show v3-alpha:docs/src/content/docs/changelog.mdx | awk '
+            /^## \[Unreleased\]/ { found=1; next }
+            found && /^## / { exit }
+            found && !/^$/ { print }
+            ' > v3_release_notes.md
+            
+            echo "📝 v3 changelog content (first 10 lines):"
+            head -10 v3_release_notes.md || echo "No content found"
+            echo "Total lines: $(wc -l < v3_release_notes.md)"
+          else
+            echo "⚠️ v3 changelog not accessible from current context"
+          fi
+
+  test-version-detection:
+    name: Test Version Detection
+    runs-on: ubuntu-latest  
+    needs: test-permissions
+    if: needs.test-permissions.outputs.authorized == 'true'
+    outputs:
+      v2_current_version: ${{ steps.versions.outputs.v2_current }}
+      v2_next_patch: ${{ steps.versions.outputs.v2_next_patch }}
+      v2_next_minor: ${{ steps.versions.outputs.v2_next_minor }}
+      v2_next_major: ${{ steps.versions.outputs.v2_next_major }}
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Test version detection logic
+        id: versions
+        run: |
+          echo "🧪 Testing version detection..."
+          
+          # Test v2 version parsing
+          if [ -f "v2/cmd/wails/internal/version.txt" ]; then
+            CURRENT_V2=$(cat v2/cmd/wails/internal/version.txt | sed 's/^v//')
+            echo "Current v2 version: v$CURRENT_V2"
+            echo "v2_current=v$CURRENT_V2" >> $GITHUB_OUTPUT
+            
+            # Parse and increment
+            IFS='.' read -ra VERSION_PARTS <<< "$CURRENT_V2"
+            MAJOR=${VERSION_PARTS[0]}
+            MINOR=${VERSION_PARTS[1]}
+            PATCH=${VERSION_PARTS[2]}
+            
+            PATCH_VERSION="v$MAJOR.$MINOR.$((PATCH + 1))"
+            MINOR_VERSION="v$MAJOR.$((MINOR + 1)).0"
+            MAJOR_VERSION="v$((MAJOR + 1)).0.0"
+            
+            echo "v2_next_patch=$PATCH_VERSION" >> $GITHUB_OUTPUT
+            echo "v2_next_minor=$MINOR_VERSION" >> $GITHUB_OUTPUT  
+            echo "v2_next_major=$MAJOR_VERSION" >> $GITHUB_OUTPUT
+            
+            echo "✅ Patch: v$CURRENT_V2 → $PATCH_VERSION"
+            echo "✅ Minor: v$CURRENT_V2 → $MINOR_VERSION"
+            echo "✅ Major: v$CURRENT_V2 → $MAJOR_VERSION"
+          else
+            echo "❌ v2 version file not found"
+          fi
+
+  test-commit-analysis:
+    name: Test Commit Analysis
+    runs-on: ubuntu-latest
+    needs: test-permissions
+    if: needs.test-permissions.outputs.authorized == 'true'
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Test commit analysis
+        run: |
+          echo "🧪 Testing commit analysis..."
+          
+          # Get recent commits for testing
+          echo "Recent commits:"
+          git log --oneline -10
+          
+          # Test conventional commit detection
+          RECENT_COMMITS=$(git log --oneline --since="7 days ago")
+          echo "Commits from last 7 days:"
+          echo "$RECENT_COMMITS"
+          
+          # Analyze for release type
+          RELEASE_TYPE="patch"
+          if echo "$RECENT_COMMITS" | grep -q "feat!\|fix!\|BREAKING CHANGE:"; then
+            RELEASE_TYPE="major"
+          elif echo "$RECENT_COMMITS" | grep -q "feat\|BREAKING CHANGE"; then
+            RELEASE_TYPE="minor"
+          fi
+          
+          echo "✅ Detected release type: $RELEASE_TYPE"
+
+  test-summary:
+    name: Test Summary
+    runs-on: ubuntu-latest
+    needs: [test-permissions, test-changelog-extraction, test-version-detection, test-commit-analysis]
+    if: always()
+    steps:
+      - name: Print test results
+        run: |
+          echo "# 🧪 Nightly Release Workflow Test Results" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          
+          if [ "${{ needs.test-permissions.result }}" == "success" ]; then
+            echo "✅ **Permissions Test**: Passed" >> $GITHUB_STEP_SUMMARY
+          else
+            echo "❌ **Permissions Test**: Failed" >> $GITHUB_STEP_SUMMARY
+          fi
+          
+          if [ "${{ needs.test-changelog-extraction.result }}" == "success" ]; then
+            echo "✅ **Changelog Extraction**: Passed" >> $GITHUB_STEP_SUMMARY
+          else
+            echo "❌ **Changelog Extraction**: Failed" >> $GITHUB_STEP_SUMMARY
+          fi
+          
+          if [ "${{ needs.test-version-detection.result }}" == "success" ]; then
+            echo "✅ **Version Detection**: Passed" >> $GITHUB_STEP_SUMMARY
+            echo "  - Current v2: ${{ needs.test-version-detection.outputs.v2_current_version }}" >> $GITHUB_STEP_SUMMARY
+            echo "  - Next patch: ${{ needs.test-version-detection.outputs.v2_next_patch }}" >> $GITHUB_STEP_SUMMARY
+            echo "  - Next minor: ${{ needs.test-version-detection.outputs.v2_next_minor }}" >> $GITHUB_STEP_SUMMARY
+            echo "  - Next major: ${{ needs.test-version-detection.outputs.v2_next_major }}" >> $GITHUB_STEP_SUMMARY
+          else
+            echo "❌ **Version Detection**: Failed" >> $GITHUB_STEP_SUMMARY
+          fi
+          
+          if [ "${{ needs.test-commit-analysis.result }}" == "success" ]; then
+            echo "✅ **Commit Analysis**: Passed" >> $GITHUB_STEP_SUMMARY
+          else
+            echo "❌ **Commit Analysis**: Failed" >> $GITHUB_STEP_SUMMARY
+          fi
+          
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "**Note**: This was a dry-run test. No actual releases were created." >> $GITHUB_STEP_SUMMARY

.github/workflows/test-simple.yml

@@ -0,0 +1,11 @@
+name: Test Simple
+
+on:
+  workflow_dispatch:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+    - name: Test
+      run: echo "Hello World"

.github/workflows/unreleased-changelog-trigger.yml

@@ -0,0 +1,128 @@
+name: Auto Release on Changelog Update
+
+on:
+  push:
+    branches:
+      - v3-alpha
+    paths:
+      - 'v3/UNRELEASED_CHANGELOG.md'
+  workflow_dispatch:
+    inputs:
+      dry_run:
+        description: 'Run in dry-run mode (no actual release)'
+        required: false
+        default: false
+        type: boolean
+
+jobs:
+  check-permissions:
+    name: Check Release Permissions
+    runs-on: ubuntu-latest
+    outputs:
+      authorized: ${{ steps.check.outputs.authorized }}
+    steps:
+      - name: Check if user is authorized for releases
+        id: check
+        run: |
+          # Only allow specific users to trigger releases
+          AUTHORIZED_USERS="leaanthony"
+          
+          if [[ "$AUTHORIZED_USERS" == *"${{ github.actor }}"* ]]; then
+            echo "✅ User ${{ github.actor }} is authorized for releases"
+            echo "authorized=true" >> $GITHUB_OUTPUT
+          else
+            echo "❌ User ${{ github.actor }} is not authorized for releases"
+            echo "authorized=false" >> $GITHUB_OUTPUT
+          fi
+
+  trigger-release:
+    name: Trigger v3-alpha Release
+    permissions:
+      contents: read
+    runs-on: ubuntu-latest
+    needs: check-permissions
+    if: needs.check-permissions.outputs.authorized == 'true'
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          ref: v3-alpha
+          fetch-depth: 0
+          token: ${{ secrets.WAILS_REPO_TOKEN || github.token }}
+
+      - name: Check for unreleased changelog content
+        id: changelog_check
+        run: |
+          echo "🔍 Checking UNRELEASED_CHANGELOG.md for content..."
+          
+          cd v3
+          # Check if UNRELEASED_CHANGELOG.md has actual content beyond the template
+          if [ -f "UNRELEASED_CHANGELOG.md" ]; then
+            # Use a simple check for actual content (bullet points starting with -)
+            CONTENT_LINES=$(grep -E "^\s*-\s+[^[:space:]]" UNRELEASED_CHANGELOG.md | wc -l)
+            if [ "$CONTENT_LINES" -gt 0 ]; then
+              echo "✅ Found $CONTENT_LINES content lines in UNRELEASED_CHANGELOG.md"
+              echo "has_content=true" >> $GITHUB_OUTPUT
+            else
+              echo "ℹ️  No actual content found in UNRELEASED_CHANGELOG.md"
+              echo "has_content=false" >> $GITHUB_OUTPUT
+            fi
+          else
+            echo "❌ UNRELEASED_CHANGELOG.md not found"
+            echo "has_content=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Trigger nightly release workflow
+        if: steps.changelog_check.outputs.has_content == 'true'
+        uses: actions/github-script@v7
+        with:
+          github-token: ${{ secrets.WAILS_REPO_TOKEN || github.token }}
+          script: |
+            const response = await github.rest.actions.createWorkflowDispatch({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              workflow_id: 'nightly-release-v3.yml',
+              ref: 'v3-alpha',
+              inputs: {
+                force_release: 'true',
+                dry_run: '${{ github.event.inputs.dry_run || "false" }}'
+              }
+            });
+            
+            console.log('🚀 Successfully triggered nightly release workflow');
+            console.log(`Workflow dispatch response status: ${response.status}`);
+            
+            // Create a summary
+            core.summary
+              .addHeading('🚀 Auto Release Triggered')
+              .addRaw('The v3-alpha release workflow has been automatically triggered due to changes in UNRELEASED_CHANGELOG.md')
+              .addTable([
+                [{data: 'Trigger', header: true}, {data: 'Value', header: true}],
+                ['Repository', context.repo.repo],
+                ['Branch', 'v3-alpha'],
+                ['Actor', context.actor],
+                ['Dry Run', '${{ github.event.inputs.dry_run || "false" }}'],
+                ['Force Release', 'true']
+              ])
+              .addRaw('\n---\n*This release was automatically triggered by the unreleased-changelog-trigger workflow*')
+              .write();
+
+      - name: No content found
+        if: steps.changelog_check.outputs.has_content == 'false'
+        run: |
+          echo "ℹ️  No content found in UNRELEASED_CHANGELOG.md, skipping release trigger"
+          echo "## ℹ️  No Release Triggered" >> $GITHUB_STEP_SUMMARY
+          echo "**Reason:** UNRELEASED_CHANGELOG.md does not contain actual changelog content" >> $GITHUB_STEP_SUMMARY
+          echo "**Action:** No release workflow was triggered" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "To trigger a release, add actual changelog entries to the UNRELEASED_CHANGELOG.md file." >> $GITHUB_STEP_SUMMARY
+
+      - name: Unauthorized user
+        if: needs.check-permissions.outputs.authorized == 'false'
+        run: |
+          echo "❌ User ${{ github.actor }} is not authorized to trigger releases"
+          echo "## ❌ Unauthorized Release Attempt" >> $GITHUB_STEP_SUMMARY
+          echo "**User:** ${{ github.actor }}" >> $GITHUB_STEP_SUMMARY
+          echo "**Action:** Release trigger was blocked due to insufficient permissions" >> $GITHUB_STEP_SUMMARY
+          echo "" >> $GITHUB_STEP_SUMMARY
+          echo "Only authorized users can trigger automatic releases via changelog updates." >> $GITHUB_STEP_SUMMARY

.github/workflows/upload-source-documents.yml

@@ -15,7 +15,7 @@ jobs:
 
       - name: Verify Changed files
         id: changed-files
-        uses: tj-actions/changed-files@v41
+        uses: step-security/changed-files@3dbe17c78367e7d60f00d78ae6781a35be47b4a1 # v45.0.1
         with:
           files: |
             website/**/*.mdx

.github/workflows/v3-docs.yml

@@ -0,0 +1,51 @@
+name: Deploy to GitHub Pages
+
+on:
+  # Trigger the workflow every time you push to the `main` branch
+  # Using a different branch name? Replace `main` with your branch's name
+  push:
+    branches: [v3-alpha]
+    paths:
+      - 'docs/**'
+      - '.github/workflows/v3-docs.yml'
+  # Allows you to run this workflow manually from the Actions tab on GitHub.
+  workflow_dispatch:
+
+# Allow this job to clone the repo and create a page deployment
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    if: github.event.repository.fork == false
+    steps:
+      - name: Checkout your repository using git
+        uses: actions/checkout@v4
+      - name: Install D2
+        run: |
+          curl -fsSL https://d2lang.com/install.sh > install.sh
+          chmod +x install.sh
+          ./install.sh
+          sudo cp ~/.local/bin/d2 /usr/local/bin/d2
+          d2 --version
+          rm install.sh
+      - name: Install, build, and upload your site output
+        uses: withastro/action@v2
+        with:
+           path: docs
+           node-version: 20 # The specific version of Node that should be used to build your site. Defaults to 18. (optional)
+        # package-manager: pnpm@latest # The Node package manager that should be used to install dependencies and build your site. Automatically detected based on your lockfile. (optional)
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -37,5 +37,61 @@ v2/cmd/wails/internal/commands/initialise/templates/testtemplates/
 /websitev3/site/
 /v3/examples/plugins/bin/testapp
 
+# V3 Example binaries - ignore executables that match directory names
+/v3/examples/badge-custom/badge-custom
+/v3/examples/badge/badge
+/v3/examples/binding/binding
+/v3/examples/cancel-async/cancel-async
+/v3/examples/cancel-chaining/cancel-chaining
+/v3/examples/clipboard/clipboard
+/v3/examples/contextmenus/contextmenus
+/v3/examples/dev/dev
+/v3/examples/dialogs-basic/dialogs-basic
+/v3/examples/dialogs/dialogs
+/v3/examples/drag-n-drop/drag-n-drop
+/v3/examples/environment/environment
+/v3/examples/events-bug/events-bug
+/v3/examples/events/events
+/v3/examples/file-association/file-association
+/v3/examples/frameless/frameless
+/v3/examples/gin-example/gin-example
+/v3/examples/gin-routing/gin-routing
+/v3/examples/gin-service/gin-service
+/v3/examples/hide-window/hide-window
+/v3/examples/html-dnd-api/html-dnd-api
+/v3/examples/ignore-mouse/ignore-mouse
+/v3/examples/keybindings/keybindings
+/v3/examples/menu/menu
+/v3/examples/notifications/notifications
+/v3/examples/panic-handling/panic-handling
+/v3/examples/plain/plain
+/v3/examples/raw-message/raw-message
+/v3/examples/screen/screen
+/v3/examples/services/services
+/v3/examples/show-macos-toolbar/show-macos-toolbar
+/v3/examples/single-instance/single-instance
+/v3/examples/systray-basic/systray-basic
+/v3/examples/systray-custom/systray-custom
+/v3/examples/systray-menu/systray-menu
+/v3/examples/video/video
+/v3/examples/window-api/window-api
+/v3/examples/window-call/window-call
+/v3/examples/window-menu/window-menu
+/v3/examples/window/window
+/v3/examples/wml/wml
+
+# Common binary names in examples
+/v3/examples/*/main
+/v3/examples/*/app
+/v3/examples/*/changeme
+/v3/examples/*/testbuild-*
+
 # Temporary called mkdocs, should be renamed to more standard -website or similar
-/mkdocs-website/site
+/docs/site
+.aider*
+.aider*
+.cache
+.local
+
+# Ignore local iOS test app
+/v3/testiosapp/

.prettierrc.yml

@@ -1,6 +1,7 @@
 overrides:
   - files:
       - "**/*.md"
+      - "**/*.mdx"
     options:
       printWidth: 80
       proseWrap: always

AGENTS.md

@@ -0,0 +1,144 @@
+# AI Agent Instructions for Wails v3
+
+## Issue Tracking with bd (beads)
+
+**IMPORTANT**: This project uses **bd (beads)** for ALL issue tracking. Do NOT use markdown TODOs, task lists, or other tracking methods.
+
+### Why bd?
+
+- Dependency-aware: Track blockers and relationships between issues
+- Git-friendly: Auto-syncs to JSONL for version control
+- Agent-optimized: JSON output, ready work detection, discovered-from links
+- Prevents duplicate tracking systems and confusion
+
+### Quick Start
+
+**Check for ready work:**
+```bash
+bd ready --json
+```
+
+**Create new issues:**
+```bash
+bd create "Issue title" -t bug|feature|task -p 0-4 --json
+bd create "Issue title" -p 1 --deps discovered-from:bd-123 --json
+bd create "Subtask" --parent <epic-id> --json  # Hierarchical subtask (gets ID like epic-id.1)
+```
+
+**Claim and update:**
+```bash
+bd update bd-42 --status in_progress --json
+bd update bd-42 --priority 1 --json
+```
+
+**Complete work:**
+```bash
+bd close bd-42 --reason "Completed" --json
+```
+
+### Issue Types
+
+- `bug` - Something broken
+- `feature` - New functionality
+- `task` - Work item (tests, docs, refactoring)
+- `epic` - Large feature with subtasks
+- `chore` - Maintenance (dependencies, tooling)
+
+### Priorities
+
+- `0` - Critical (security, data loss, broken builds)
+- `1` - High (major features, important bugs)
+- `2` - Medium (default, nice-to-have)
+- `3` - Low (polish, optimization)
+- `4` - Backlog (future ideas)
+
+### Workflow for AI Agents
+
+1. **Check ready work**: `bd ready` shows unblocked issues
+2. **Claim your task**: `bd update <id> --status in_progress`
+3. **Work on it**: Implement, test, document
+4. **Discover new work?** Create linked issue:
+   - `bd create "Found bug" -p 1 --deps discovered-from:<parent-id>`
+5. **Complete**: `bd close <id> --reason "Done"`
+6. **Commit together**: Always commit the `.beads/issues.jsonl` file together with the code changes so issue state stays in sync with code state
+
+### Auto-Sync
+
+bd automatically syncs with git:
+- Exports to `.beads/issues.jsonl` after changes (5s debounce)
+- Imports from JSONL when newer (e.g., after `git pull`)
+- No manual export/import needed!
+
+### GitHub Copilot Integration
+
+If using GitHub Copilot, also create `.github/copilot-instructions.md` for automatic instruction loading.
+Run `bd onboard` to get the content, or see step 2 of the onboard instructions.
+
+### MCP Server (Recommended)
+
+If using Claude or MCP-compatible clients, install the beads MCP server:
+
+```bash
+pip install beads-mcp
+```
+
+Add to MCP config (e.g., `~/.config/claude/config.json`):
+```json
+{
+  "beads": {
+    "command": "beads-mcp",
+    "args": []
+  }
+}
+```
+
+Then use `mcp__beads__*` functions instead of CLI commands.
+
+### Managing AI-Generated Planning Documents
+
+AI assistants often create planning and design documents during development:
+- PLAN.md, IMPLEMENTATION.md, ARCHITECTURE.md
+- DESIGN.md, CODEBASE_SUMMARY.md, INTEGRATION_PLAN.md
+- TESTING_GUIDE.md, TECHNICAL_DESIGN.md, and similar files
+
+**Best Practice: Use a dedicated directory for these ephemeral files**
+
+**Recommended approach:**
+- Create a `history/` directory in the project root
+- Store ALL AI-generated planning/design docs in `history/`
+- Keep the repository root clean and focused on permanent project files
+- Only access `history/` when explicitly asked to review past planning
+
+**Example .gitignore entry (optional):**
+```
+# AI planning documents (ephemeral)
+history/
+```
+
+**Benefits:**
+- Clean repository root
+- Clear separation between ephemeral and permanent documentation
+- Easy to exclude from version control if desired
+- Preserves planning history for archeological research
+- Reduces noise when browsing the project
+
+### CLI Help
+
+Run `bd <command> --help` to see all available flags for any command.
+For example: `bd create --help` shows `--parent`, `--deps`, `--assignee`, etc.
+
+### Important Rules
+
+- Use bd for ALL task tracking
+- Always use `--json` flag for programmatic use
+- Link discovered work with `discovered-from` dependencies
+- Check `bd ready` before asking "what should I work on?"
+- Store AI planning docs in `history/` directory
+- Run `bd <cmd> --help` to discover available flags
+- **ALWAYS run `coderabbit --plain` before committing** to get code analysis and catch issues early
+- Do NOT create markdown TODO lists
+- Do NOT use external issue trackers
+- Do NOT duplicate tracking systems
+- Do NOT clutter repo root with planning documents
+
+For more details, see README.md and QUICKSTART.md.

CNAME

@@ -0,0 +1 @@
+v3alpha.wails.io

IOS_ARCHITECTURE.md

@@ -0,0 +1,419 @@
+# Wails v3 iOS Architecture
+
+## Executive Summary
+
+This document provides a comprehensive technical architecture for iOS support in Wails v3. The implementation enables Go applications to run natively on iOS with a WKWebView frontend, maintaining the Wails philosophy of using web technologies for UI while leveraging Go for business logic.
+
+## Table of Contents
+
+1. [Architecture Overview](#architecture-overview)
+2. [Core Components](#core-components)
+3. [Layer Architecture](#layer-architecture)
+4. [Implementation Details](#implementation-details)
+5. [Battery Optimization](#battery-optimization)
+6. [Build System](#build-system)
+7. [Security Considerations](#security-considerations)
+8. [API Reference](#api-reference)
+
+## Architecture Overview
+
+### Design Principles
+
+1. **Battery Efficiency First**: All architectural decisions prioritize battery life
+2. **No Network Ports**: Asset serving happens in-process via native APIs
+3. **Minimal WebView Instances**: Maximum 2 concurrent WebViews (1 primary, 1 for transitions)
+4. **Native Integration**: Deep iOS integration using Objective-C runtime
+5. **Wails v3 Compatibility**: Maintain API compatibility with existing Wails v3 applications
+
+### High-Level Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                     iOS Application                          │
+├─────────────────────────────────────────────────────────────┤
+│                    UIKit Framework                           │
+│  ┌─────────────────────────────────────────────────────┐   │
+│  │              WailsViewController                     │   │
+│  │  ┌───────────────────────────────────────────────┐  │   │
+│  │  │            WKWebView Instance                  │  │   │
+│  │  │  ┌─────────────────────────────────────────┐  │  │   │
+│  │  │  │         Web Application (HTML/JS)        │  │  │   │
+│  │  │  └─────────────────────────────────────────┘  │  │   │
+│  │  └───────────────────────────────────────────────┘  │   │
+│  └─────────────────────────────────────────────────────┘   │
+├─────────────────────────────────────────────────────────────┤
+│                  Bridge Layer (CGO)                          │
+│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐     │
+│  │URL Handler   │  │JS Bridge     │  │Message Handler│     │
+│  └──────────────┘  └──────────────┘  └──────────────┘     │
+├─────────────────────────────────────────────────────────────┤
+│                    Go Runtime                                │
+│  ┌──────────────────────────────────────────────────────┐  │
+│  │                 Wails Application                     │  │
+│  │  ┌──────────┐  ┌──────────┐  ┌──────────────────┐  │  │
+│  │  │App Logic │  │Services  │  │Asset Server      │  │  │
+│  │  └──────────┘  └──────────┘  └──────────────────┘  │  │
+│  └──────────────────────────────────────────────────────┘  │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Core Components
+
+### 1. Platform Layer (`application_ios.go`)
+
+**Purpose**: Go interface for iOS platform operations
+
+**Key Functions**:
+- `platformRun()`: Initialize and run the iOS application
+- `platformQuit()`: Gracefully shutdown the application
+- `isDarkMode()`: Detect iOS dark mode state
+- `ExecuteJavaScript(windowID uint, js string)`: Execute JS in WebView
+
+**Exported Go Functions (Called from Objective-C)**:
+- `ServeAssetRequest(windowID C.uint, urlStr *C.char, callbackID C.uint)`
+- `HandleJSMessage(windowID C.uint, message *C.char)`
+
+### 2. Native iOS Layer (`application_ios.m`)
+
+**Components**:
+
+#### WailsSchemeHandler
+```objc
+@interface WailsSchemeHandler : NSObject <WKURLSchemeHandler>
+```
+- Implements `WKURLSchemeHandler` protocol
+- Intercepts `wails://` URL requests
+- Bridges to Go for asset serving
+- Manages pending requests with callback IDs
+
+**Methods**:
+- `startURLSchemeTask:`: Intercept request, call Go handler
+- `stopURLSchemeTask:`: Cancel pending request
+- `completeRequest:withData:mimeType:`: Complete request with data from Go
+
+#### WailsMessageHandler
+```objc
+@interface WailsMessageHandler : NSObject <WKScriptMessageHandler>
+```
+- Implements JavaScript to Go communication
+- Handles `window.webkit.messageHandlers.external.postMessage()`
+- Serializes messages to JSON for Go processing
+
+**Methods**:
+- `userContentController:didReceiveScriptMessage:`: Process JS messages
+
+#### WailsViewController
+```objc
+@interface WailsViewController : UIViewController
+```
+- Main view controller containing WKWebView
+- Manages WebView lifecycle
+- Handles JavaScript execution requests
+
+**Properties**:
+- `webView`: WKWebView instance
+- `schemeHandler`: Custom URL scheme handler
+- `messageHandler`: JS message handler
+- `windowID`: Unique window identifier
+
+**Methods**:
+- `viewDidLoad`: Initialize WebView with configuration
+- `executeJavaScript:`: Run JS code in WebView
+
+### 3. Bridge Layer (CGO)
+
+**C Interface Functions**:
+```c
+void ios_app_init(void);                    // Initialize iOS app
+void ios_app_run(void);                     // Run main loop
+void ios_app_quit(void);                    // Quit application
+bool ios_is_dark_mode(void);                // Check dark mode
+unsigned int ios_create_webview(void);      // Create WebView
+void ios_execute_javascript(unsigned int windowID, const char* js);
+void ios_complete_request(unsigned int callbackID, const char* data, const char* mimeType);
+```
+
+## Layer Architecture
+
+### Layer 1: Presentation Layer (WebView)
+
+**Responsibilities**:
+- Render HTML/CSS/JavaScript UI
+- Handle user interactions
+- Communicate with native layer
+
+**Key Features**:
+- WKWebView for modern web standards
+- Hardware-accelerated rendering
+- Efficient memory management
+
+### Layer 2: Communication Layer
+
+**Request Interception**:
+```
+WebView Request → WKURLSchemeHandler → Go ServeAssetRequest → AssetServer → Response
+```
+
+**JavaScript Bridge**:
+```
+JS postMessage → WKScriptMessageHandler → Go HandleJSMessage → Process → ExecuteJavaScript
+```
+
+### Layer 3: Application Layer (Go)
+
+**Components**:
+- Application lifecycle management
+- Service binding and method calls
+- Asset serving from embedded fs.FS
+- Business logic execution
+
+### Layer 4: Platform Integration Layer
+
+**iOS-Specific Features**:
+- Dark mode detection
+- System appearance integration
+- iOS-specific optimizations
+
+## Implementation Details
+
+### Request Handling Flow
+
+1. **WebView makes request** to `wails://localhost/path`
+2. **WKURLSchemeHandler intercepts** request
+3. **Creates callback ID** and stores `WKURLSchemeTask`
+4. **Calls Go function** `ServeAssetRequest` with URL and callback ID
+5. **Go processes request** through AssetServer
+6. **Go calls** `ios_complete_request` with response data
+7. **Objective-C completes** the `WKURLSchemeTask` with response
+
+### JavaScript Execution Flow
+
+1. **Go calls** `ios_execute_javascript` with JS code
+2. **Bridge dispatches** to main thread
+3. **WKWebView evaluates** JavaScript
+4. **Completion handler** logs any errors
+
+### Message Passing Flow
+
+1. **JavaScript calls** `window.webkit.messageHandlers.wails.postMessage(data)`
+2. **WKScriptMessageHandler receives** message
+3. **Serializes to JSON** and passes to Go
+4. **Go processes** message in `HandleJSMessage`
+5. **Go can respond** via `ExecuteJavaScript`
+
+## Battery Optimization
+
+### WebView Configuration
+
+```objc
+// Disable unnecessary features
+config.suppressesIncrementalRendering = NO;
+config.allowsInlineMediaPlayback = YES;
+config.mediaTypesRequiringUserActionForPlayback = WKAudiovisualMediaTypeNone;
+```
+
+### Memory Management
+
+1. **Single WebView Instance**: Reuse instead of creating new instances
+2. **Automatic Reference Counting**: Use ARC for Objective-C objects
+3. **Lazy Loading**: Initialize components only when needed
+4. **Resource Cleanup**: Properly release resources when done
+
+### Request Optimization
+
+1. **In-Process Serving**: No network overhead
+2. **Direct Memory Transfer**: Pass data directly without serialization
+3. **Efficient Caching**: Leverage WKWebView's built-in cache
+4. **Minimal Wake Locks**: No background network activity
+
+## Build System
+
+### Build Tags
+
+```go
+//go:build ios
+```
+
+### CGO Configuration
+
+```go
+#cgo CFLAGS: -x objective-c -fobjc-arc
+#cgo LDFLAGS: -framework Foundation -framework UIKit -framework WebKit
+```
+
+### Build Script (`build_ios.sh`)
+
+**Steps**:
+1. Check dependencies (go, xcodebuild, xcrun)
+2. Set up iOS cross-compilation environment
+3. Build Go binary with iOS tags
+4. Create app bundle structure
+5. Generate Info.plist
+6. Sign for simulator
+7. Create launch script
+
+**Environment Variables**:
+```bash
+export CGO_ENABLED=1
+export GOOS=ios
+export GOARCH=arm64
+export SDK_PATH=$(xcrun --sdk iphonesimulator --show-sdk-path)
+```
+
+### Simulator Deployment
+
+```bash
+xcrun simctl install "$DEVICE_ID" "WailsIOSDemo.app"
+xcrun simctl launch "$DEVICE_ID" "com.wails.iosdemo"
+```
+
+## Security Considerations
+
+### URL Scheme Security
+
+1. **Custom Scheme**: Use `wails://` to avoid conflicts
+2. **Origin Validation**: Only serve to authorized WebViews
+3. **No External Access**: Scheme handler only responds to app's WebView
+
+### JavaScript Execution
+
+1. **Input Validation**: Sanitize JS code before execution
+2. **Sandboxed Execution**: WKWebView provides isolation
+3. **No eval()**: Avoid dynamic code evaluation
+
+### Data Protection
+
+1. **In-Memory Only**: No temporary files on disk
+2. **ATS Compliance**: App Transport Security enabled
+3. **Secure Communication**: All data stays within app process
+
+## API Reference
+
+### Go API
+
+#### Application Functions
+
+```go
+// Create new iOS application
+app := application.New(application.Options{
+    Name: "App Name",
+    Description: "App Description",
+})
+
+// Run the application
+app.Run()
+
+// Execute JavaScript
+app.ExecuteJavaScript(windowID, "console.log('Hello')")
+```
+
+#### Service Binding
+
+```go
+type MyService struct{}
+
+func (s *MyService) Greet(name string) string {
+    return fmt.Sprintf("Hello, %s!", name)
+}
+
+app := application.New(application.Options{
+    Services: []application.Service{
+        application.NewService(&MyService{}),
+    },
+})
+```
+
+### JavaScript API
+
+#### Send Message to Go
+
+```javascript
+window.webkit.messageHandlers.wails.postMessage({
+    type: 'methodCall',
+    service: 'MyService',
+    method: 'Greet',
+    args: ['World']
+});
+```
+
+#### Receive from Go
+
+```javascript
+window.wailsCallback = function(data) {
+    console.log('Received:', data);
+};
+```
+
+### Objective-C Bridge API
+
+#### From Go to Objective-C
+
+```c
+// Execute JavaScript
+ios_execute_javascript(windowID, "alert('Hello')");
+
+// Complete asset request
+ios_complete_request(callbackID, htmlData, "text/html");
+```
+
+#### From Objective-C to Go
+
+```c
+// Serve asset request
+ServeAssetRequest(windowID, urlString, callbackID);
+
+// Handle JavaScript message
+HandleJSMessage(windowID, jsonMessage);
+```
+
+## Performance Metrics
+
+### Target Metrics
+
+- **WebView Creation**: < 100ms
+- **Asset Request**: < 10ms for cached, < 50ms for first load
+- **JS Execution**: < 5ms for simple scripts
+- **Message Passing**: < 2ms round trip
+- **Memory Usage**: < 50MB baseline
+- **Battery Impact**: < 2% per hour active use
+
+### Monitoring
+
+1. **Xcode Instruments**: CPU, Memory, Energy profiling
+2. **WebView Inspector**: JavaScript performance
+3. **Go Profiling**: pprof for Go code analysis
+
+## Future Enhancements
+
+### Phase 1: Core Stability
+- [ ] Production-ready error handling
+- [ ] Comprehensive test suite
+- [ ] Performance optimization
+
+### Phase 2: Feature Parity
+- [ ] Multiple window support
+- [ ] System tray integration
+- [ ] Native menu implementation
+
+### Phase 3: iOS-Specific Features
+- [ ] Widget extension support
+- [ ] App Clip support
+- [ ] ShareSheet integration
+- [ ] Siri Shortcuts
+
+### Phase 4: Advanced Features
+- [ ] Background task support
+- [ ] Push notifications
+- [ ] CloudKit integration
+- [ ] Apple Watch companion app
+
+## Conclusion
+
+This architecture provides a solid foundation for iOS support in Wails v3. The design prioritizes battery efficiency, native performance, and seamless integration with the existing Wails ecosystem. The proof of concept demonstrates all four required capabilities:
+
+1. ✅ **WebView Creation**: Native WKWebView with optimized configuration
+2. ✅ **Request Interception**: Custom scheme handler without network ports
+3. ✅ **JavaScript Execution**: Bidirectional communication bridge
+4. ✅ **iOS Simulator Support**: Complete build and deployment pipeline
+
+The architecture is designed to scale from this proof of concept to a full production implementation while maintaining the simplicity and elegance that Wails developers expect.

Taskfile.yaml

@@ -16,6 +16,11 @@ includes:
     dir: v3
     optional: true
 
+  docs:
+    taskfile: docs
+    dir: docs
+    optional: true
+
 tasks:
   contributors:check:
     cmds:

docs/.gitignore

@@ -0,0 +1,21 @@
+# build output
+dist/
+# generated types
+.astro/
+
+# dependencies
+node_modules/
+
+# logs
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+
+
+# environment variables
+.env
+.env.production
+
+# macOS-specific files
+.DS_Store

docs/.npmrc

@@ -0,0 +1 @@
+save-exact=true

docs/.vscode/extensions.json

@@ -0,0 +1,4 @@
+{
+  "recommendations": ["astro-build.astro-vscode"],
+  "unwantedRecommendations": []
+}

docs/.vscode/launch.json

@@ -0,0 +1,11 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "command": "./node_modules/.bin/astro dev",
+      "name": "Development server",
+      "request": "launch",
+      "type": "node-terminal"
+    }
+  ]
+}

docs/CNAME

@@ -0,0 +1 @@
+v3alpha.wails.io

docs/README.md

@@ -0,0 +1,65 @@
+# Wails v3 Documentation
+
+[![Built with Starlight](https://astro.badg.es/v2/built-with-starlight/tiny.svg)](https://starlight.astro.build)
+
+World-class documentation for Wails v3, redesigned following Netflix documentation principles.
+
+## 📚 Documentation Redesign (2025-10-01)
+
+This documentation has been completely redesigned to follow the **Netflix approach** to developer documentation:
+
+- **Problem-first framing** - Start with why, not what
+- **Progressive disclosure** - Multiple entry points for different skill levels
+- **Real production examples** - No toy code
+- **Story-Code-Context pattern** - Why → How → When
+- **Scannable content** - Clear structure, visual aids
+
+**Status:** Foundation complete (~20%), ready for content migration
+
+See [IMPLEMENTATION_SUMMARY.md](./IMPLEMENTATION_SUMMARY.md) for full details.
+
+## 🚀 Project Structure
+
+Inside of your Astro + Starlight project, you'll see the following folders and
+files:
+
+```sh
+.
+├── public/
+├── src/
+│   ├── assets/
+│   ├── content/
+│   │   ├── docs/
+│   │   └── config.ts
+│   └── env.d.ts
+├── astro.config.mjs
+├── package.json
+└── tsconfig.json
+```
+
+Starlight looks for `.md` or `.mdx` files in the `src/content/docs/` directory.
+Each file is exposed as a route based on its file name.
+
+Images can be added to `src/assets/` and embedded in Markdown with a relative
+link.
+
+Static assets, like favicons, can be placed in the `public/` directory.
+
+## 🧞 Commands
+
+All commands are run from the root of the project, from a terminal:
+
+| Command                   | Action                                           |
+| :------------------------ | :----------------------------------------------- |
+| `npm install`             | Installs dependencies                            |
+| `npm run dev`             | Starts local dev server at `localhost:4321`      |
+| `npm run build`           | Build your production site to `./dist/`          |
+| `npm run preview`         | Preview your build locally, before deploying     |
+| `npm run astro ...`       | Run CLI commands like `astro add`, `astro check` |
+| `npm run astro -- --help` | Get help using the Astro CLI                     |
+
+## 👀 Want to learn more?
+
+Check out [Starlight’s docs](https://starlight.astro.build/), read
+[the Astro documentation](https://docs.astro.build), or jump into the
+[Astro Discord server](https://astro.build/chat).

docs/Taskfile.yml

@@ -0,0 +1,36 @@
+# https://taskfile.dev
+
+version: '3'
+
+vars:
+  # Change this to switch package managers: bun, npm, pnpm, yarn
+  PKG_MANAGER: npm
+
+tasks:
+
+  setup:
+    summary: Setup the project (including D2 diagram tool)
+    preconditions:
+      - sh: '{{.PKG_MANAGER}} --version'
+        msg: "Looks like {{.PKG_MANAGER}} isn't installed."
+      - sh: 'go version'
+        msg: "Go is not installed. Install from https://go.dev/dl/"
+    cmds:
+      - '{{.PKG_MANAGER}} install'
+      - go install oss.terrastruct.com/d2@latest
+      - echo "✓ Setup complete. D2 installed to $(go env GOPATH)/bin/d2"
+
+  dev:
+    summary: Run the dev server
+    deps: [setup]
+    cmds:
+      - '{{.PKG_MANAGER}} run dev'
+
+  build:
+    summary: Build the docs
+    preconditions:
+      - sh: '{{.PKG_MANAGER}} --version'
+        msg: "Looks like {{.PKG_MANAGER}} isn't installed."
+    cmds:
+      - '{{.PKG_MANAGER}} run build'
+

docs/astro.config.mjs

@@ -0,0 +1,357 @@
+// @ts-check
+import { defineConfig } from "astro/config";
+import { fileURLToPath } from "node:url";
+import starlight from "@astrojs/starlight";
+import sitemap from "@astrojs/sitemap";
+import starlightLinksValidator from "starlight-links-validator";
+import starlightImageZoom from "starlight-image-zoom";
+import starlightBlog from "starlight-blog";
+import { authors } from "./src/content/authors";
+import d2 from 'astro-d2';
+import react from '@astrojs/react';
+
+// https://astro.build/config
+export default defineConfig({
+  site: "https://wails.io",
+  vite: {
+    resolve: {
+      alias: {
+        '@components': fileURLToPath(new URL('./src/components', import.meta.url))
+      }
+    }
+  },
+  trailingSlash: "ignore",
+  compressHTML: true,
+  output: "static",
+  build: { format: "directory" },
+  devToolbar: { enabled: true },
+  integrations: [
+    react(),
+    d2(),
+    sitemap(),
+    starlight({
+      title: "",
+      titleDelimiter: "",
+      logo: {
+        dark: "./src/assets/wails-logo-horizontal-dark.svg",
+        light: "./src/assets/wails-logo-horizontal-light.svg",
+      },
+      favicon: "./public/favicon.svg",
+      description: "Build beautiful desktop applications using Go and modern web technologies.",
+      pagefind: true,
+      customCss: ["./src/stylesheets/extra.css"],
+      lastUpdated: true,
+      pagination: true,
+      editLink: {
+        baseUrl: "https://github.com/wailsapp/wails/edit/v3-alpha/docs",
+      },
+      social: [
+        { icon: 'github', label: 'GitHub', href: 'https://github.com/wailsapp/wails' },
+        { icon: 'discord', label: 'Discord', href: 'https://discord.gg/JDdSxwjhGf' },
+        { icon: 'x.com', label: 'X', href: 'https://x.com/wailsapp' },
+      ],
+      head: [
+        {
+          tag: 'script',
+          content: `
+            document.addEventListener('DOMContentLoaded', () => {
+              const socialLinks = document.querySelector('.social-icons');
+              if (socialLinks) {
+                const sponsorLink = document.createElement('a');
+                sponsorLink.href = 'https://github.com/sponsors/leaanthony';
+                sponsorLink.className = 'sl-flex';
+                sponsorLink.title = 'Sponsor';
+                sponsorLink.innerHTML = '<span class="sr-only">Sponsor</span><svg xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="#ef4444" stroke="none"><path d="M19 14c1.49-1.46 3-3.21 3-5.5A5.5 5.5 0 0 0 16.5 3c-1.76 0-3 .5-4.5 2-1.5-1.5-2.74-2-4.5-2A5.5 5.5 0 0 0 2 8.5c0 2.3 1.5 4.05 3 5.5l7 7Z"/></svg>';
+                socialLinks.appendChild(sponsorLink);
+              }
+            });
+          `,
+        },
+      ],
+      defaultLocale: "root",
+      locales: {
+        root: { label: "English", lang: "en", dir: "ltr" },
+      },
+      plugins: [
+        starlightImageZoom(),
+        starlightBlog({
+          title: "Wails Blog",
+          authors: authors,
+        }),
+      ],
+      sidebar: [
+        { label: "Home", link: "/" },
+
+        // Progressive Onboarding - Netflix Principle: Start with the problem
+        { label: "Why Wails?", link: "/quick-start/why-wails" },
+
+        {
+          label: "Quick Start",
+          collapsed: false,
+          items: [
+            { label: "Installation", link: "/quick-start/installation" },
+            { label: "Your First App", link: "/quick-start/first-app" },
+            { label: "Next Steps", link: "/quick-start/next-steps" },
+          ],
+        },
+
+        // Tutorials
+        {
+          label: "Tutorials",
+          collapsed: true,
+          autogenerate: { directory: "tutorials" },
+        },
+
+        // Core Concepts
+        {
+          label: "Core Concepts",
+          collapsed: true,
+          items: [
+            { label: "How Wails Works", link: "/concepts/architecture" },
+            { label: "Manager API", link: "/concepts/manager-api" },
+            { label: "Application Lifecycle", link: "/concepts/lifecycle" },
+            { label: "Go-Frontend Bridge", link: "/concepts/bridge" },
+            { label: "Build System", link: "/concepts/build-system" },
+          ],
+        },
+
+        {
+          label: "Features",
+          collapsed: true,
+          items: [
+            {
+              label: "Windows",
+              collapsed: true,
+              items: [
+                { label: "Window Basics", link: "/features/windows/basics" },
+                { label: "Window Options", link: "/features/windows/options" },
+                { label: "Multiple Windows", link: "/features/windows/multiple" },
+                { label: "Frameless Windows", link: "/features/windows/frameless" },
+                { label: "Window Events", link: "/features/windows/events" },
+              ],
+            },
+            {
+              label: "Menus",
+              collapsed: true,
+              items: [
+                { label: "Application Menus", link: "/features/menus/application" },
+                { label: "Context Menus", link: "/features/menus/context" },
+                { label: "System Tray Menus", link: "/features/menus/systray" },
+                { label: "Menu Reference", link: "/features/menus/reference" },
+              ],
+            },
+            {
+              label: "Bindings & Services",
+              collapsed: true,
+              items: [
+                { label: "Method Binding", link: "/features/bindings/methods" },
+                { label: "Services", link: "/features/bindings/services" },
+                { label: "Advanced Binding", link: "/features/bindings/advanced" },
+                { label: "Best Practices", link: "/features/bindings/best-practices" },
+              ],
+            },
+            {
+              label: "Events",
+              collapsed: true,
+              items: [
+                { label: "Event System", link: "/features/events/system" },
+                { label: "Application Events", link: "/features/events/application" },
+                { label: "Window Events", link: "/features/events/window" },
+                { label: "Custom Events", link: "/features/events/custom" },
+              ],
+            },
+            {
+              label: "Dialogs",
+              collapsed: true,
+              items: [
+                { label: "File Dialogs", link: "/features/dialogs/file" },
+                { label: "Message Dialogs", link: "/features/dialogs/message" },
+                { label: "Custom Dialogs", link: "/features/dialogs/custom" },
+              ],
+            },
+            {
+              label: "Clipboard",
+              collapsed: true,
+              autogenerate: { directory: "features/clipboard" },
+            },
+            {
+              label: "Browser",
+              collapsed: true,
+              autogenerate: { directory: "features/browser" },
+            },
+            {
+              label: "Drag & Drop",
+              collapsed: true,
+              autogenerate: { directory: "features/drag-and-drop" },
+            },
+            {
+              label: "Keyboard",
+              collapsed: true,
+              autogenerate: { directory: "features/keyboard" },
+            },
+            {
+              label: "Notifications",
+              collapsed: true,
+              autogenerate: { directory: "features/notifications" },
+            },
+            {
+              label: "Screens",
+              collapsed: true,
+              autogenerate: { directory: "features/screens" },
+            },
+            {
+              label: "Environment",
+              collapsed: true,
+              autogenerate: { directory: "features/environment" },
+            },
+            {
+              label: "Platform-Specific",
+              collapsed: true,
+              autogenerate: { directory: "features/platform" },
+            },
+          ],
+        },
+
+        // Guides - Task-oriented patterns (Netflix: When to use it, when not to use it)
+        {
+          label: "Guides",
+          collapsed: true,
+          items: [
+            {
+              label: "Development",
+              collapsed: true,
+              items: [
+                { label: "Project Structure", link: "/guides/dev/project-structure" },
+                { label: "Development Workflow", link: "/guides/dev/workflow" },
+                { label: "Debugging", link: "/guides/dev/debugging" },
+                { label: "Testing", link: "/guides/dev/testing" },
+              ],
+            },
+            {
+              label: "Building & Packaging",
+              collapsed: true,
+              items: [
+                { label: "Building Applications", link: "/guides/build/building" },
+                { label: "Build Customization", link: "/guides/build/customization" },
+                { label: "Cross-Platform Builds", link: "/guides/build/cross-platform" },
+                { label: "Code Signing", link: "/guides/build/signing" },
+                { label: "Windows Packaging", link: "/guides/build/windows" },
+                { label: "macOS Packaging", link: "/guides/build/macos" },
+                { label: "Linux Packaging", link: "/guides/build/linux" },
+                { label: "MSIX Packaging", link: "/guides/build/msix" },
+              ],
+            },
+            {
+              label: "Distribution",
+              collapsed: true,
+              items: [
+                { label: "Auto-Updates", link: "/guides/distribution/auto-updates" },
+                { label: "File Associations", link: "/guides/distribution/file-associations" },
+                { label: "Custom Protocols", link: "/guides/distribution/custom-protocols" },
+                { label: "Single Instance", link: "/guides/distribution/single-instance" },
+              ],
+            },
+            {
+              label: "Integration Patterns",
+              collapsed: true,
+              items: [
+                { label: "Using Gin Router", link: "/guides/patterns/gin-routing" },
+                { label: "Gin Services", link: "/guides/patterns/gin-services" },
+                { label: "Database Integration", link: "/guides/patterns/database" },
+                { label: "REST APIs", link: "/guides/patterns/rest-api" },
+              ],
+            },
+            {
+              label: "Advanced Topics",
+              collapsed: true,
+              items: [
+                { label: "Server Build", link: "/guides/server-build", badge: { text: "Experimental", variant: "caution" } },
+                { label: "Custom Templates", link: "/guides/advanced/custom-templates" },
+                { label: "WML (Wails Markup)", link: "/guides/advanced/wml" },
+                { label: "Panic Handling", link: "/guides/advanced/panic-handling" },
+                { label: "Security Best Practices", link: "/guides/advanced/security" },
+              ],
+            },
+          ],
+        },
+
+        // Reference - Comprehensive API docs (Netflix: Complete technical reference)
+        {
+          label: "API Reference",
+          collapsed: true,
+          items: [
+            { label: "Overview", link: "/reference/overview" },
+            { label: "Application", link: "/reference/application" },
+            { label: "Window", link: "/reference/window" },
+            { label: "Menu", link: "/reference/menu" },
+            { label: "Events", link: "/reference/events" },
+            { label: "Dialogs", link: "/reference/dialogs" },
+            { label: "Frontend Runtime", link: "/reference/frontend-runtime" },
+            { label: "CLI", link: "/reference/cli" },
+          ],
+        },
+
+        // Contributing
+        {
+          label: "Contributing",
+          collapsed: true,
+          items: [
+            { label: "Getting Started", link: "/contributing/getting-started" },
+            { label: "Development Setup", link: "/contributing/setup" },
+            { label: "Coding Standards", link: "/contributing/standards" },
+          ],
+        },
+
+        // Migration & Troubleshooting
+        {
+          label: "Migration",
+          collapsed: true,
+          items: [
+            { label: "From v2 to v3", link: "/migration/v2-to-v3" },
+            { label: "From Electron", link: "/migration/from-electron" },
+          ],
+        },
+
+        {
+          label: "Troubleshooting",
+          collapsed: true,
+          autogenerate: { directory: "troubleshooting" },
+        },
+
+        // Community & Resources
+        {
+          label: "Community",
+          collapsed: true,
+          items: [
+            { label: "Links", link: "/community/links" },
+            { label: "Templates", link: "/community/templates" },
+            {
+              label: "Showcase",
+              collapsed: true,
+              items: [
+                { label: "Overview", link: "/community/showcase" },
+                {
+                  label: "Applications",
+                  autogenerate: {
+                    directory: "community/showcase",
+                    collapsed: true,
+                  },
+                },
+              ],
+            },
+          ],
+        },
+
+        { label: "What's New", link: "/whats-new" },
+        { label: "Status", link: "/status" },
+        { label: "Changelog", link: "/changelog" },
+        {
+          label: "Sponsor",
+          link: "https://github.com/sponsors/leaanthony",
+          badge: { text: "❤️" },
+        },
+        { label: "Credits", link: "/credits" },
+      ],
+    }),
+  ],
+});

docs/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "wails-docs",
+  "type": "module",
+  "version": "0.0.1",
+  "scripts": {
+    "dev": "astro dev",
+    "start": "astro dev",
+    "build": "astro check && astro build",
+    "preview": "astro preview",
+    "astro": "astro"
+  },
+  "dependencies": {
+    "@astrojs/check": "^0.9.4",
+    "@astrojs/react": "^4.1.0",
+    "@astrojs/starlight": "0.36.2",
+    "@types/react": "^19.0.1",
+    "@types/react-dom": "^19.0.2",
+    "astro": "^5.0.0",
+    "astro-d2": "^0.5.0",
+    "framer-motion": "^11.14.4",
+    "motion": "^11.14.4",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "sharp": "^0.33.5",
+    "starlight-blog": "0.25.1",
+    "starlight-image-zoom": "^0.9.0",
+    "starlight-links-validator": "^0.13.4",
+    "starlight-showcases": "^0.2.0",
+    "typescript": "^5.7.2"
+  }
+}

docs/public/favicon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="100%" height="100%" version="1.1" viewBox="0 0 550 310" xml:space="preserve" style="fill-rule:evenodd;clip-rule:evenodd;stroke-linejoin:round;stroke-miterlimit:2"><g><path d="M0.883,-0.081L0.121,0.081L0.256,-0.063L0.883,-0.081Z" transform="matrix(-166.599,4.57132,4.57132,166.599,147.403,167.648)" style="fill:url(#_Linear1);fill-rule:nonzero"/></g><g><path d="M0.878,-0.285L-0.073,0.71L-1.186,0.542L0.015,0.207L-0.846,0.077L0.355,-0.258L-0.505,-0.388L0.649,-0.71L0.878,-0.285Z" transform="matrix(-106.443,-16.0669,-16.0669,106.443,428.19,188.033)" style="fill:url(#_Linear2);fill-rule:nonzero"/></g><g><path d="M0.44,-0.04L0.265,-0.056L0.177,0.437L-0.311,-0.255L0.262,-0.437L0.568,-0.437L0.44,-0.04Z" transform="matrix(-114.484,-162.408,-162.408,114.484,333.291,285.804)" style="fill:url(#_Linear3);fill-rule:nonzero"/></g><g><path d="M0.622,-0.115L0.761,-0.115L0.806,-0.013L0.826,0.182L0.622,-0.115Z" transform="matrix(238.126,298.893,298.893,-238.126,113.516,-150.536)" style="fill:url(#_Linear4);fill-rule:nonzero"/></g><g><path d="M0.467,0.005L0.49,0.062L0.271,-0.062L0.467,0.005Z" transform="matrix(-369.529,-97.4118,-97.4118,369.529,582.38,94.027)" style="fill:url(#_Linear5);fill-rule:nonzero"/></g><g><path d="M0.2,0.001L0.219,-0.018L0.614,0.012L0.519,0.089L0.282,0.068L0.2,0.135L0.463,0.194L0.374,0.266L0.138,0.186L0.047,0.033L-0.131,-0.266L0.2,0.001Z" transform="matrix(-496.156,-53.9751,-53.9751,496.156,367.888,125.085)" style="fill:url(#_Linear6);fill-rule:nonzero"/></g><g><path d="M269.095,104.527L287.764,111.419L263.632,106.75L269.095,104.527Z" transform="matrix(0.436503,-1.22916,4.88651,1.73532,-368.043,253.619)" style="fill:#fff"/></g><defs><linearGradient id="_Linear1" x1="0" x2="1" y1="0" y2="0" gradientTransform="matrix(1,-3.46945e-18,3.46945e-18,1,0,-3.05761e-06)" gradientUnits="userSpaceOnUse"><stop offset="0" style="stop-color:#e33232;stop-opacity:1"/><stop offset="1" style="stop-color:#6b000d;stop-opacity:1"/></linearGradient><linearGradient id="_Linear2" x1="0" x2="1" y1="0" y2="0" gradientTransform="matrix(1,0,0,1,0,-2.75467e-06)" gradientUnits="userSpaceOnUse"><stop offset="0" style="stop-color:#e33232;stop-opacity:1"/><stop offset="1" style="stop-color:#6b000d;stop-opacity:1"/></linearGradient><linearGradient id="_Linear3" x1="0" x2="1" y1="0" y2="0" gradientTransform="matrix(1,-1.11022e-16,1.11022e-16,1,0,-2.61861e-06)" gradientUnits="userSpaceOnUse"><stop offset="0" style="stop-color:#e33232;stop-opacity:1"/><stop offset="1" style="stop-color:#6b000d;stop-opacity:1"/></linearGradient><linearGradient id="_Linear4" x1="0" x2="1" y1="0" y2="0" gradientTransform="matrix(-0.801899,-0.59746,0.59746,-0.801899,1.3495,0.447457)" gradientUnits="userSpaceOnUse"><stop offset="0" style="stop-color:#e33232;stop-opacity:1"/><stop offset="1" style="stop-color:#6b000d;stop-opacity:1"/></linearGradient><linearGradient id="_Linear5" x1="0" x2="1" y1="0" y2="0" gradientTransform="matrix(1,-2.77556e-17,2.77556e-17,1,0,-1.92826e-06)" gradientUnits="userSpaceOnUse"><stop offset="0" style="stop-color:#e33232;stop-opacity:1"/><stop offset="1" style="stop-color:#6b000d;stop-opacity:1"/></linearGradient><linearGradient id="_Linear6" x1="0" x2="1" y1="0" y2="0" gradientTransform="matrix(1,0,0,1,0,9.68429e-07)" gradientUnits="userSpaceOnUse"><stop offset="0" style="stop-color:#e33232;stop-opacity:1"/><stop offset="1" style="stop-color:#6b000d;stop-opacity:1"/></linearGradient></defs></svg>