From c72bee0b5423fda79fc033e41265636185b640cc Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 15 Jan 2026 21:42:37 +0000
Subject: [PATCH 1/6] Initial plan


From 7376ef088cea056e3e54ff8510ed3d1fc053c238 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 15 Jan 2026 21:45:32 +0000
Subject: [PATCH 2/6] Add docs.yml workflow for GitHub Pages deployment

Co-authored-by: abernier <76580+abernier@users.noreply.github.com>
---
 .github/workflows/docs.yml | 51 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)
 create mode 100644 .github/workflows/docs.yml

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
new file mode 100644
index 00000000..43ca7ae1
--- /dev/null
+++ b/.github/workflows/docs.yml
@@ -0,0 +1,51 @@
+name: Build documentation and deploy to GitHub Pages
+on:
+  push:
+    branches: ['main']
+  workflow_dispatch:
+
+# Cancel previous run (see: https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#concurrency)
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    uses: pmndrs/docs/.github/workflows/build.yml@v2
+    with:
+      mdx: 'docs'
+      libname: 'Poimandres'
+      libname_short: 'pmndrs'
+      libname_dotsuffix_label: 'docs'
+      libname_dotsuffix_href: 'https://pmnd.rs'
+      home_redirect: '/getting-started/introduction'
+      icon: '🖨️'
+      logo: 'gutenberg.jpg'
+      github: 'https://github.com/pmndrs/docs'
+      discord: ''
+      theme_primary: '#323e48'
+      theme_scheme: 'tonalSpot'
+      theme_contrast: '0'
+      theme_note: '#1f6feb'
+      theme_tip: '#238636'
+      theme_important: '#8957e5'
+      theme_warning: '#d29922'
+      theme_caution: '#da3633'
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+
+    # Grant GITHUB_TOKEN the permissions required to make a Pages deployment
+    permissions:
+      pages: write # to deploy to Pages
+      id-token: write # to verify the deployment originates from an appropriate source
+
+    # Deploy to the github-pages environment
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

From 078626e4c9d7d2fd1c508faa0b6fbbe001a6854c Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 15 Jan 2026 21:47:14 +0000
Subject: [PATCH 3/6] Remove unnecessary empty discord parameter from docs.yml

Co-authored-by: abernier <76580+abernier@users.noreply.github.com>
---
 .github/workflows/docs.yml | 1 -
 1 file changed, 1 deletion(-)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 43ca7ae1..e38aa095 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -22,7 +22,6 @@ jobs:
       icon: '🖨️'
       logo: 'gutenberg.jpg'
       github: 'https://github.com/pmndrs/docs'
-      discord: ''
       theme_primary: '#323e48'
       theme_scheme: 'tonalSpot'
       theme_contrast: '0'

From 534d2887dfb6a29b48dfb1a75e1763c72db333b6 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 15 Jan 2026 21:50:15 +0000
Subject: [PATCH 4/6] docs(changeset): Add docs.yml workflow for GitHub Pages
 deployment

---
 .changeset/cyan-dancers-ring.md | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 .changeset/cyan-dancers-ring.md

diff --git a/.changeset/cyan-dancers-ring.md b/.changeset/cyan-dancers-ring.md
new file mode 100644
index 00000000..fcf3b9ef
--- /dev/null
+++ b/.changeset/cyan-dancers-ring.md
@@ -0,0 +1,5 @@
+---
+'@pmndrs/docs': major
+---
+
+Add docs.yml workflow for GitHub Pages deployment

From 7071700c2edcfea4c10346c805c42588872d2370 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 15 Jan 2026 21:50:57 +0000
Subject: [PATCH 5/6] Add explicit permissions to build job for security

Co-authored-by: abernier <76580+abernier@users.noreply.github.com>
---
 .github/workflows/docs.yml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index e38aa095..4397980f 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -11,6 +11,10 @@ concurrency:
 
 jobs:
   build:
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
     uses: pmndrs/docs/.github/workflows/build.yml@v2
     with:
       mdx: 'docs'

From 429c6f343eb23a0ef054a6f1851958515a59a014 Mon Sep 17 00:00:00 2001
From: Antoine BERNIER <antoine.bernier@gmail.com>
Date: Thu, 15 Jan 2026 22:53:29 +0100
Subject: [PATCH 6/6] Update workflow to use main branch for build.yml

---
 .github/workflows/docs.yml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 4397980f..2ef582a4 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -15,7 +15,7 @@ jobs:
       contents: read
       pages: write
       id-token: write
-    uses: pmndrs/docs/.github/workflows/build.yml@v2
+    uses: pmndrs/docs/.github/workflows/build.yml@main
     with:
       mdx: 'docs'
       libname: 'Poimandres'
@@ -34,6 +34,7 @@ jobs:
       theme_important: '#8957e5'
       theme_warning: '#d29922'
       theme_caution: '#da3633'
+      docker_tag: '3'
 
   deploy:
     needs: build