diff --git a/.github/workflows/deploy-mkdocs.yml b/.github/workflows/deploy-mkdocs.yml
new file mode 100644
index 000000000..cd8b9fcfa
--- /dev/null
+++ b/.github/workflows/deploy-mkdocs.yml
@@ -0,0 +1,24 @@
+name: "Push MkDocs to gh-pages"
+on:
+  push:
+    branches: [ "master" ]
+
+  workflow_dispatch:
+        
+jobs:
+  deploy-mkdocs:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: docs
+    steps:
+      - uses: actions/checkout@v3
+      - name: Install python
+        uses: actions/setup-python@v4
+        with:
+            python-version: '3.10'
+            cache: 'pip'
+      - name: Install dependencies 
+        run: pip install -r requirements.txt
+      - name: Build and push
+        run: mkdocs gh-deploy --force
diff --git a/docs/requirements.txt b/docs/requirements.txt
new file mode 100644
index 000000000..2cbd20262
--- /dev/null
+++ b/docs/requirements.txt
@@ -0,0 +1,3 @@
+mkdocs-material
+pymdown-extensions
+mkdocs