diff --git a/foundations-macros/Cargo.toml b/foundations-macros/Cargo.toml
index cfd2dbf..50fd257 100644
--- a/foundations-macros/Cargo.toml
+++ b/foundations-macros/Cargo.toml
@@ -6,6 +6,7 @@ edition = { workspace = true }
 repository = { workspace = true }
 authors = { workspace = true }
 license = { workspace = true }
+readme = "../README.md"
 
 [lib]
 proc-macro = true
diff --git a/foundations/Cargo.toml b/foundations/Cargo.toml
index 5a5d034..fce651e 100644
--- a/foundations/Cargo.toml
+++ b/foundations/Cargo.toml
@@ -6,6 +6,7 @@ edition = { workspace = true }
 repository = { workspace = true }
 authors = { workspace = true }
 license = { workspace = true }
+readme = "../README.md"
 
 [package.metadata.release]
 # run in the context of workspace root