diff --git a/.github/workflows/docs.yaml b/.github/workflows/docs.yaml
index 999d000..5850b69 100644
--- a/.github/workflows/docs.yaml
+++ b/.github/workflows/docs.yaml
@@ -39,7 +39,7 @@ jobs:
         uses: peaceiris/actions-gh-pages@v4
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./docs
+          publish_dir: ./publish
           # this puts the docs for this tag under gh-pages:/rc/<tag>/
           destination_dir: rc/${{ github.event.release.tag_name }}
 
@@ -48,4 +48,4 @@ jobs:
         uses: peaceiris/actions-gh-pages@v4
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: ./docs
+          publish_dir: ./publish
diff --git a/.gitignore b/.gitignore
index e061bf7..a35dc10 100644
--- a/.gitignore
+++ b/.gitignore
@@ -8,4 +8,4 @@ __pycache__/
 .vscode/
 tests/__pycache__/
 dist/
-docs/
+publish/
diff --git a/Makefile b/Makefile
index 87024ef..833c240 100644
--- a/Makefile
+++ b/Makefile
@@ -23,7 +23,13 @@ fmt: install dev # run code formatter
 	uv run ruff format kratix_sdk tests
 
 generate-docs: install dev # create API documentation
-	uv run pdoc src/kratix_sdk -o docs
+	VERSION=$(shell python3 -c 'import json; print(*json.load(open(".release-please-manifest.json")).values(), end="")') \
+	uv run pdoc src/kratix_sdk \
+	--output-directory publish \
+	--template-directory docs/templates \
+	--logo logo.svg \
+	--favicon favicon.ico
+	cp -r docs/assets/* publish/
 
 build-and-load-configure-image: # build example docker image and load it into kind
 	docker buildx build --builder kratix-image-builder --load --platform linux/arm64 \
diff --git a/docs/assets/favicon.ico b/docs/assets/favicon.ico
new file mode 100644
index 0000000..32c3698
Binary files /dev/null and b/docs/assets/favicon.ico differ
diff --git a/docs/assets/logo.svg b/docs/assets/logo.svg
new file mode 100644
index 0000000..96c5a6a
--- /dev/null
+++ b/docs/assets/logo.svg
@@ -0,0 +1,3 @@
+<svg width="524" height="104" viewBox="0 0 524 104" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M28.66 68.6C28.66 70.712 30.388 72.44 32.5 72.44C33.524 72.44 34.484 72.056 35.188 71.352L51.7 54.84L68.148 71.352C68.852 72.056 69.812 72.44 70.9 72.44C73.012 72.44 74.74 70.712 74.74 68.6C74.74 67.576 74.292 66.616 73.588 65.912L57.14 49.4L73.588 32.952C74.292 32.248 74.74 31.288 74.74 30.2C74.74 28.088 73.012 26.36 70.9 26.36C69.812 26.36 68.852 26.808 68.148 27.512L36.34 59.32V30.2C36.34 28.088 34.612 26.36 32.5 26.36C30.388 26.36 28.66 28.088 28.66 30.2V68.6ZM97.785 68.6C97.785 70.712 99.513 72.44 101.625 72.44C103.737 72.44 105.465 70.712 105.465 68.6V56.44H116.025L130.937 71.352C131.641 72.056 132.601 72.44 133.625 72.44C135.737 72.44 137.465 70.712 137.465 68.6C137.465 67.576 137.017 66.616 136.377 65.912L125.945 55.544C131.705 53.432 135.865 47.928 135.865 41.4C135.865 33.208 129.273 26.552 121.145 26.36H101.625C99.513 26.36 97.785 28.088 97.785 30.2V68.6ZM121.145 34.04C124.985 34.232 128.185 37.496 128.185 41.4C128.185 45.432 124.857 48.76 120.825 48.76H105.465V34.04H121.145ZM158.423 66.744C158.103 67.32 157.975 67.96 157.975 68.6C157.975 70.712 159.703 72.44 161.815 72.44C163.415 72.44 164.567 71.416 165.335 70.072L169.495 62.84H198.359L202.519 70.072C203.287 71.416 204.503 72.44 206.103 72.44C208.215 72.44 209.943 70.712 209.943 68.6C209.943 67.96 209.751 67.32 209.495 66.744L187.287 28.216C186.583 27.128 185.367 26.36 183.959 26.36C182.551 26.36 181.335 27.128 180.631 28.216L158.423 66.744ZM183.959 37.816L193.943 55.16H173.911L183.959 37.816ZM242.613 68.6C242.613 70.712 244.341 72.44 246.453 72.44C248.565 72.44 250.293 70.712 250.293 68.6V34.04H265.653C267.765 34.04 269.493 32.312 269.493 30.2C269.493 28.088 267.765 26.36 265.653 26.36H227.253C225.141 26.36 223.413 28.088 223.413 30.2C223.413 32.312 225.141 34.04 227.253 34.04H242.613V68.6ZM291.223 68.6C291.223 70.712 292.951 72.44 295.062 72.44C297.175 72.44 298.903 70.712 298.903 68.6V30.2C298.903 28.088 297.175 26.36 295.062 26.36C292.951 26.36 291.223 28.088 291.223 30.2V68.6ZM364.183 72.44C366.295 72.44 368.023 70.712 368.023 68.6C368.023 67.576 367.575 66.616 366.871 65.912L350.423 49.4L366.871 32.952C367.575 32.248 368.023 31.288 368.023 30.2C368.023 28.088 366.295 26.36 364.183 26.36C363.159 26.36 362.199 26.808 361.495 27.448L344.983 43.96L328.471 27.448C327.767 26.808 326.807 26.36 325.783 26.36C323.671 26.36 321.943 28.088 321.943 30.2C321.943 31.288 322.327 32.248 323.031 32.952L339.543 49.4L323.031 65.912C322.327 66.616 321.943 67.576 321.943 68.6C321.943 70.712 323.671 72.44 325.783 72.44C326.807 72.44 327.767 72.056 328.471 71.352L344.983 54.84L361.431 71.352C362.135 72.056 363.095 72.44 364.183 72.44ZM391.035 68.6C391.035 70.712 392.763 72.44 394.875 72.44C396.987 72.44 398.715 70.712 398.715 68.6C398.715 66.488 396.987 64.76 394.875 64.76C392.763 64.76 391.035 66.488 391.035 68.6ZM423.035 68.6C423.035 70.712 424.763 72.44 426.875 72.44C428.987 72.44 430.715 70.712 430.715 68.6V30.2C430.715 28.088 428.987 26.36 426.875 26.36C424.763 26.36 423.035 28.088 423.035 30.2V68.6ZM458.858 49.4C458.858 40.952 465.77 34.04 474.218 34.04C482.666 34.04 489.578 40.952 489.578 49.4C489.578 57.848 482.666 64.76 474.218 64.76C465.77 64.76 458.858 57.848 458.858 49.4ZM451.178 49.4C451.178 62.136 461.482 72.44 474.218 72.44C486.954 72.44 497.258 62.136 497.258 49.4C497.258 36.664 486.954 26.36 474.218 26.36C461.482 26.36 451.178 36.664 451.178 49.4Z" fill="#2C0548"/>
+</svg>
diff --git a/docs/templates/module.html.jinja2 b/docs/templates/module.html.jinja2
new file mode 100644
index 0000000..364a5a4
--- /dev/null
+++ b/docs/templates/module.html.jinja2
@@ -0,0 +1,7 @@
+{% extends "default/module.html.jinja2" %}
+{% block nav_footer %}
+    <footer>{{ module.modulename }} v{{ env["VERSION"] | default("snapshot") }}</footer>
+{% endblock %}
+{% block module_info %}
+    <h1 class="modulename">{{ module.modulename }} v{{ env["VERSION"] | default("dev") }}</h1>
+{% endblock %}
\ No newline at end of file