gramaziokohler · josemmo · Jun 4, 2026 · Jun 11, 2026 · Jun 24, 2026 · Jun 24, 2026
diff --git a/.github/CODE_OF_CONDUCT.md b/.github/CODE_OF_CONDUCT.md
@@ -23,13 +23,13 @@ include:
 Examples of unacceptable behavior by participants include:
 
 - The use of sexualized language or imagery and unwelcome sexual attention or
-  advances
+    advances
 - Trolling, insulting/derogatory comments, and personal or political attacks
 - Public or private harassment
 - Publishing others' private information, such as a physical or electronic
-  address, without explicit permission
+    address, without explicit permission
 - Other conduct which could reasonably be considered inappropriate in a
-  professional setting
+    professional setting
 
 ## Our Responsibilities
 

diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
@@ -37,7 +37,8 @@ jobs:
       - name: Generate documentation
         uses: compas-dev/compas-actions.docs@v5
         with:
-          doc_url: https://gramaziokohler.github.io/compas_cadwork
           github_token: ${{ secrets.GITHUB_TOKEN }}
           python: '3.12'
-          use_conda: false
+          generator: mkdocs
+          extras: mkdocs
+          test_docs: false
diff --git a/.gitignore b/.gitignore
@@ -94,6 +94,9 @@ ENV/
 # Rope project settings
 .ropeproject
 
+# PyCharm project settings
+.idea/
+
 # mkdocs documentation
 /site
 

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -8,6 +8,7 @@ repos:
     rev: v6.0.0
     hooks:
       - id: check-yaml
+        args: [--unsafe]  # For mkdocs.yml
       - id: check-toml
       - id: check-case-conflict
       - id: check-merge-conflict
@@ -33,6 +34,7 @@ repos:
           - mdformat-gfm-alerts
           - mdformat-ruff
           - mdformat-tables
+          - mdformat-mkdocs
         args: [--number]
 
   - repo: https://github.com/astral-sh/uv-pre-commit

diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -17,6 +17,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Switched project to Astral's uv project manager.
 - Deprecated `compas_cadwork.storage`, `compas_cadwork.datamodel`, `compas_cadwork.scene`, and `compas_cadwork.utilities`.
+- Migrated documentation from Sphinx to MkDocs
 
 ### Removed
 

diff --git a/LICENSE b/LICENSE
@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2024 Gramazio Kohler Research, ETH Zurich
+Copyright (c) 2024-present Gramazio Kohler Research, ETH Zurich
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

diff --git a/README.md b/README.md
@@ -8,15 +8,15 @@
 [![Twitter Follow](https://img.shields.io/twitter/follow/compas_dev?style=social)](https://twitter.com/compas_dev)
 [![Made with COMPAS](https://compas.dev/badge.svg)](https://compas.dev/)
 
-![COMPAS Cadwork](https://raw.githubusercontent.com/gramaziokohler/compas_cadwork/refs/heads/main/compas_cadwork.jpg)
+![COMPAS Cadwork](https://raw.githubusercontent.com/gramaziokohler/compas_cadwork/refs/heads/main/docs/assets/images/dome.jpg)
 
 COMPAS cadwork is an open-source Python package which allows you to harness the power of the COMPAS framework inside cadwork 3d.
 Make use of COMPAS' extensive geometry kernel, data structures, and algorithms to create, manipulate, and analyze your 3d models in cadwork.
 Gain access to the COMPAS ecosystem which includes a wide range of tools and libraries engineered for the AEC industry.
 
 ## Installation
 
-> For the different installation options please see the [installation guide](https://gramaziokohler.github.io/compas_cadwork/latest/installation.html).
+> For the different installation options please see the [complete documentation](https://gramaziokohler.github.io/compas_cadwork/).
 
 To install `compas_cadwork` directly to cadwork 3d, run:
 

diff --git a/data/stand_w_drills.json b/data/stand_w_drills.json
diff --git a/docs/_images/element_dimension.JPG b/docs/_images/element_dimension.JPG
diff --git a/docs/_images/half_dome.JPG b/docs/_images/half_dome.JPG
diff --git a/docs/_images/half_dome_texture.JPG b/docs/_images/half_dome_texture.JPG
diff --git a/docs/_images/half_dome_viewer.JPG b/docs/_images/half_dome_viewer.JPG
diff --git a/docs/_static/PLACEHOLDER b/docs/_static/PLACEHOLDER
diff --git a/docs/api.rst b/docs/api.rst
diff --git a/docs/api/compas_cadwork.conversions.md b/docs/api/compas_cadwork.conversions.md
@@ -0,0 +1 @@
+# ::: compas_cadwork.conversions
diff --git a/docs/api/compas_cadwork.conversions.rst b/docs/api/compas_cadwork.conversions.rst
diff --git a/docs/api/compas_cadwork.datamodel.md b/docs/api/compas_cadwork.datamodel.md
@@ -0,0 +1 @@
+# ::: compas_cadwork.datamodel
diff --git a/docs/api/compas_cadwork.datamodel.rst b/docs/api/compas_cadwork.datamodel.rst
diff --git a/docs/api/compas_cadwork.elements.md b/docs/api/compas_cadwork.elements.md
@@ -0,0 +1 @@
+# ::: compas_cadwork.elements
diff --git a/docs/api/compas_cadwork.md b/docs/api/compas_cadwork.md
@@ -0,0 +1 @@
+# ::: compas_cadwork
diff --git a/docs/api/compas_cadwork.scene.md b/docs/api/compas_cadwork.scene.md
@@ -0,0 +1 @@
+# ::: compas_cadwork.scene
diff --git a/docs/api/compas_cadwork.scene.rst b/docs/api/compas_cadwork.scene.rst
diff --git a/docs/api/compas_cadwork.utilities.md b/docs/api/compas_cadwork.utilities.md
@@ -0,0 +1 @@
+# ::: compas_cadwork.utilities
diff --git a/docs/api/compas_cadwork.utilities.rst b/docs/api/compas_cadwork.utilities.rst
diff --git a/docs/assets/images/beams-showcase.png b/docs/assets/images/beams-showcase.png
diff --git a/docs/_images/half_dome_trimmed.gif → docs/assets/images/dome.gif b/docs/_images/half_dome_trimmed.gif → docs/assets/images/dome.gif
diff --git a/compas_cadwork.jpg → docs/assets/images/dome.jpg b/compas_cadwork.jpg → docs/assets/images/dome.jpg
diff --git a/docs/assets/images/logo.png b/docs/assets/images/logo.png
diff --git a/docs/assets/images/panels-showcase.png b/docs/assets/images/panels-showcase.png
diff --git a/docs/assets/stylesheets/custom.css b/docs/assets/stylesheets/custom.css
@@ -0,0 +1,3 @@
+:root > * {
+  --md-primary-fg-color: #0092d2;
+}
diff --git a/docs/conf.py b/docs/conf.py
diff --git a/docs/examples.rst b/docs/examples.rst