diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index 9d4facd80d7f028fd6e57d05f5d37a4837c79655..859bdd776303faaa2a1ef46901b53287586156ef 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -1,5 +1,6 @@
 stages:
   - test
+  - deploy
 
 Run tests:
   stage: test
@@ -15,4 +16,23 @@ Run tests:
     - main
     - merge_requests
 
+pages:
+  stage: deploy
+  image: python:3.12
+  needs: ["Run tests"]  # Wait for tests to pass
+  before_script:
+    - pip install uv
+    - uv venv
+    - uv pip install mkdocs mkdocs-material mike mkdocstrings mkdocstrings-python ruff
+  script:
+    - rm -rf public
+    - uv run mkdocs build --site-dir public
+  artifacts:
+    paths:
+      - public
+  rules:
+    - if: '$CI_COMMIT_BRANCH == $CI_DEFAULT_BRANCH'
+
+
+