diff --git a/readme.md b/readme.md
index 35658e0..9173bb6 100644
--- a/readme.md
+++ b/readme.md
@@ -44,3 +44,55 @@ create_venv(
 Create a virtual environment with default path `venv` by running `bazel run //:create_venv`. The generated script accepts a single, optional argument to define the virtual environment path.
 
 The created venv will use the default Python 3 runtime defined in rules_python.
+
+## Multi-platform setup
+
+`uv` supports generating platform-specific requirements files, and `rules_uv` exposes this configuration, and a multi-platform setup might look like this:
+
+```starlark
+load("@rules_multirun//:defs.bzl", "multirun")
+load("@rules_uv//uv:pip.bzl", "pip_compile")
+load("@rules_uv//uv:venv.bzl", "create_venv")
+
+pip_compile(
+    name = "generate_requirements_linux_txt",
+    python_platform = "x86_64-unknown-linux-gnu",
+    requirements_txt = "requirements_linux.txt",
+)
+
+pip_compile(
+    name = "generate_requirements_macos_txt",
+    python_platform = "aarch64-apple-darwin",
+    requirements_txt = "requirements_macos.txt",
+)
+
+multirun(
+    name = "generate_requirements_lock",
+    commands = [
+        ":generate_requirements_linux_txt",
+        ":generate_requirements_macos_txt",
+    ],
+    jobs = 0,
+)
+
+create_venv(
+    name = "create_venv",
+    requirements_txt = select({
+        "@platforms//os:linux": ":requirements_linux.txt",
+        "@platforms//os:osx": ":requirements_macos.txt",
+    }),
+)
+```
+
+This makes use of the excellent [rules_multirun](https://github.com/keith/rules_multirun).
+
+To match up with `rules_python`, a bzlmod config will look something like:
+
+```starlark
+pip.parse(
+    hub_name = "pip",
+    python_version = "3.11",
+    requirements_darwin = "//:requirements_macos.txt",
+    requirements_linux = "//:requirements_linux.txt",
+)
+```