diff --git a/pyproject.toml b/pyproject.toml
index b3af42a..2145041 100755
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -33,6 +33,9 @@ packages = ["dlunch"]
 [tool.setuptools.dynamic]
 dependencies = {file = ["requirements/requirements.txt"]}
 
+[tool.setuptools.dynamic.optional-dependencies]
+docs = {file = ['requirements/docs-requirements.txt']}
+
 [tool.black]
 line-length = 79
 include = '\.pyi?$'
@@ -56,7 +59,6 @@ version = "3.3.0"
 version_files = [
     "dlunch/core.py",
     "pyproject.toml:version",
-    "docs/conf.py:release",
 ]
 tag_format = "v$version"
 changelog_file = "changelog.md"
diff --git a/requirements/docs-requirements.txt b/requirements/docs-requirements.txt
new file mode 100644
index 0000000..0867596
--- /dev/null
+++ b/requirements/docs-requirements.txt
@@ -0,0 +1,10 @@
+mkdocs==1.6.1 
+mkdocstrings==0.27.0
+mkdocstrings-python==1.12.2
+mkdocs-material==9.5.44
+mkdocs-gen-files==0.4.0
+mkdocs-literate-nav==0.6.1
+mkdocs-section-index==0.3.9
+mkdocs-github-admonitions-plugin==0.0.3
+mike==2.1.2
+black==24.10.0