diff --git a/.github/workflows/deploy.yaml b/.github/workflows/deploy.yaml
index 9d89c667..c231a04f 100644
--- a/.github/workflows/deploy.yaml
+++ b/.github/workflows/deploy.yaml
@@ -4,26 +4,48 @@ on:
   push:
     branches:
       - main
+    paths-ignore:
+      - '**/README.md'
 
 jobs:
+  build:
+    name: Build Docusaurus
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 18
+          cache: yarn
+
+      - name: Install dependencies
+        run: yarn install --frozen-lockfile
+      - name: Build website
+        run: yarn build --no-minify
+
+      - name: Upload Build Artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: build
+
   deploy:
+    name: Deploy to GitHub Pages
+    needs: build
+
     permissions:
       pages: write
       id-token: write
+    
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
     runs-on: ubuntu-latest
     steps:
-      - name: Checkout main docs repo
-        uses: actions/checkout@v4
-      - name: Setup Docusaurus
-        uses: actions/setup-node@v4
-        with:
-          node-version: 18.x
-          cache: yarn
-      - name: Build website
-        run: |
-          yarn install --frozen-lockfile
-          yarn build
       - name: Deploy to GitHub Pages
+        id: deployment
         uses: actions/deploy-pages@v4
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
\ No newline at end of file