diff --git a/crates/README.md b/crates/README.md
new file mode 100644
index 0000000..a5456a3
--- /dev/null
+++ b/crates/README.md
@@ -0,0 +1,24 @@
+# Crates
+
+The standard crates used in Valence projects.
+
+All crates here are exported by the main `valence` crate. `valence` is the intended interface for both end users and plugin authors.
+
+Crates are versioned in lockstep with the exception of `valence_nbt`.
+
+Ignoring transitive dependencies and `valence_core`, the dependency graph can be described like this:
+
+```mermaid
+graph TD
+  network --> client
+	client --> instance
+	biome --> registry
+	dimension --> registry
+	instance --> biome
+	instance --> dimension
+	instance --> entity
+	player_list --> client
+	inventory --> client
+	anvil --> instance
+	entity --> block
+```