diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml
deleted file mode 100644
index 8ab18839b..000000000
--- a/.github/workflows/pages.yml
+++ /dev/null
@@ -1,49 +0,0 @@
-name: "pages"
-
-on:
-  push:
-    branches: [master]
-  workflow_dispatch:
-
-permissions:
-  contents: read
-  pages: write
-  id-token: write
-
-concurrency:
-  group: "pages"
-  cancel-in-progress: false
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - name: Install Nix
-        uses: cachix/install-nix-action@v30
-        with:
-          extra_nix_config: |
-            accept-flake-config = true
-            experimental-features = nix-command flakes
-            max-jobs = 0
-      - name: Setup Pages
-        id: pages
-        uses: actions/configure-pages@v5
-      - name: Build Pages
-        run: |
-          nix build .#docs
-      - name: Upload artifact
-        uses: actions/upload-pages-artifact@v3
-        with:
-          path: ./result
-
-  deploy:
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-    runs-on: ubuntu-latest
-    needs: build
-    steps:
-      - name: Deploy to GitHub Pages
-        id: deployment
-        uses: actions/deploy-pages@v4
diff --git a/dev/effect-pages.nix b/dev/effect-pages.nix
new file mode 100644
index 000000000..4d7cf6dbb
--- /dev/null
+++ b/dev/effect-pages.nix
@@ -0,0 +1,15 @@
+{
+  hercules-ci.github-pages = {
+    branch = "master";
+  };
+
+  perSystem =
+    { config, ... }:
+    {
+      hercules-ci.github-pages.settings = {
+        # automatic token generation by buildbot github app ??
+        # secretsMap.token = "token-for-pages";
+        contents = config.packages.docs;
+      };
+    };
+}
diff --git a/flake.nix b/flake.nix
index 2b7d79394..dfb6caa3b 100644
--- a/flake.nix
+++ b/flake.nix
@@ -55,6 +55,7 @@
 
       imports = [
         ./dev/effect-deploy.nix
+        ./dev/effect-pages.nix
         ./modules
         inputs.hercules-ci-effects.flakeModule
         inputs.lite-config.flakeModule