diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 3932be53..4a94d17f 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -1,13 +1,8 @@
 name: Deploy docs to Github Pages
 
 on:
-  push:
-    branches:
-      - master
-    paths:
-      - 'packages/docs/**'
-      - '.github/workflows/docs.yml'
-  workflow_dispatch:
+  release:
+    types: [published]
 
 permissions:
   contents: read
@@ -20,6 +15,7 @@ concurrency:
 
 jobs:
   build:
+    if: ${{ startsWith(github.ref, 'refs/tags/') && !github.event.release.prerelease }}
     runs-on: ubuntu-latest
     defaults:
       run:
@@ -28,6 +24,7 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v5
         with:
+          ref: ${{ github.event.release.tag_name }}
           fetch-depth: 0
       - uses: oven-sh/setup-bun@v2
         with: