add background blur patch

2 files changed, 33 insertions, 0 deletions

diff --git a/Sources/bar/bar.docc/patches.md b/Sources/bar/bar.docc/patches.md
index de0514a..1b05ffe 100644
--- a/Sources/bar/bar.docc/patches.md
+++ b/Sources/bar/bar.docc/patches.md
@@ -88,6 +88,7 @@ To publish, upload the patch somewhere publicly accessible (e.g., the *bar* GitH
 ### Appearance
 
 - <doc:patch-font-offset>
+- <doc:patch-background-blur>
 
 ### Functionality
 
diff --git a/Sources/bar/bar.docc/patches/patch-background-blur.md b/Sources/bar/bar.docc/patches/patch-background-blur.md
new file mode 100644
index 0000000..2f6fc2b
--- /dev/null
+++ b/Sources/bar/bar.docc/patches/patch-background-blur.md
@@ -0,0 +1,32 @@
+# Background blur
+
+Set a backdrop blur to the entire bar.
+
+This patch adds a `backgroundBlur` option (Double) to ``Config``.
+Adjust the value to increase or decrease the blur effect behind the bar.
+
+```swift
+enum Config {
+	/// The blur amount used for the bar background.
+	static let backgroundBlur: Double = 10
+}
+```
+
+> Warning: This patch uses private Apple APIs.
+Future versions of macOS might break the functionality.
+
+## Installation
+
+```shell
+curl -sL https://raw.githubusercontent.com/paninihouse/bar/refs/heads/master/patches/patch-background_blur-20260811-10fed47.patch | patch -p1
+```
+
+After applying, rebuild the program:
+
+```shell
+make install
+```
+
+## Author
+
+Tommaso Negri [@tommasongr](https://github.com/tommasongr)