diff --git a/{{cookiecutter.project_name}}/pyproject.toml b/{{cookiecutter.project_name}}/pyproject.toml
index 64ea5d8..ed0caf6 100644
--- a/{{cookiecutter.project_name}}/pyproject.toml
+++ b/{{cookiecutter.project_name}}/pyproject.toml
@@ -1,30 +1,49 @@
-[tool.poetry]
+[build-system]
+requires = ["poetry-core>=1.0.0", "poetry-dynamic-versioning"]
+build-backend = "poetry_dynamic_versioning.backend"
+
+[project]
 name = "{{cookiecutter.__project_slug}}"
-version = "0.1.0"
 description = "{{cookiecutter.project_description}}"
 authors = ["{{cookiecutter.__author}}"]
 license = "{{cookiecutter.license}}"
 readme = "README.md"
 include = ["README.md", "src/{{cookiecutter.__project_slug}}/schema", "project"]
 
+requires-python = ">=3.9"
+
+dynamic = ["version"]
+
+dependencies = [
+  "linkml-runtime >=1.8.0",
+]
+
+[project.optional-dependencies]
+docs = [
+  "mkdocs-material >=8.2.8",
+  "mkdocs-mermaid2-plugin >=1.1.1",
+  "schemasheets >= 0.1.14",
+]
+dev = [
+  # "pid4cat_model[docs]",  # no support for recursive optional dependencies: poetry#3369
+  "mkdocs-material >=8.2.8",
+  "mkdocs-mermaid2-plugin >=1.1.1",
+  "schemasheets >= 0.1.14",
+  # end repeated docs extra
+  "linkml >= 1.8.5",
+]
+[tool.poetry]
+requires-poetry = ">=2.0"
+version = "0.0.0"
+
 [tool.poetry.dependencies]
-python = "^3.9"
-linkml-runtime = "^1.1.24"
+python = ">=3.9,<4.0"  # poetry needs an upper bound for locking
+
+[tool.poetry.requires-plugins]
+poetry-dynamic-versioning = ">=1.5.0"
 
 [tool.poetry-dynamic-versioning]
 enable = true
 vcs = "git"
 style = "pep440"
 
-[tool.poetry.dev-dependencies]
-linkml = "^1.3.5"
-mkdocs-material = "^8.2.8"
-mkdocs-mermaid2-plugin = "^1.1.1"
-schemasheets = "^0.1.14"
-
-[build-system]
-requires = ["poetry-core>=1.0.0", "poetry-dynamic-versioning"]
-build-backend = "poetry_dynamic_versioning.backend"
-
-[tool.poetry.extras]
-docs = ["linkml", "mkdocs-material"]