From babe65140363a36e4238aaa76ae3817f121dfa4b Mon Sep 17 00:00:00 2001
From: Rishabh Gusain <rishabhgusain.6@gmail.com>
Date: Fri, 21 Aug 2026 02:15:51 +0530
Subject: [PATCH 1/3] docs: document minimum bun version requirement

---
 CONTRIBUTING.md | 2 +-
 package.json    | 3 ++-
 2 files changed, 3 insertions(+), 2 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 8a4d0d05e..636630bb1 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -18,7 +18,7 @@ git clone https://github.com/databuddy-analytics/Databuddy.git
 cd databuddy
 ```
 
-2. Install dependencies:
+2. Install dependencies (requires Bun ≥ 1.2.0 — run `bun --version` to check, upgrade at https://bun.sh if needed):
 
 ```bash
 bun install
diff --git a/package.json b/package.json
index 85a9b6f52..c09d8b93f 100644
--- a/package.json
+++ b/package.json
@@ -24,7 +24,8 @@
     "ultracite": "^7.6.1"
   },
   "engines": {
-    "node": ">=20"
+    "node": ">=20",
+    "bun": ">=1.2.0"
   },
   "overrides": {
     "protobufjs": ">=7.5.5",

From 6fdaca901a660529117aaa90e023dee498acedca Mon Sep 17 00:00:00 2001
From: Rishabh Gusain <rishabhgusain.6@gmail.com>
Date: Sat, 22 Aug 2026 17:00:57 +0530
Subject: [PATCH 2/3] docs(contributing): note packageManager bun pin alongside
 minimum version

---
 CONTRIBUTING.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 636630bb1..ba95fa133 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -24,6 +24,9 @@ cd databuddy
 bun install
 ```
 
+> [!NOTE]
+> Bun ≥ 1.2.0 is only the minimum required for `catalog:` protocol support. The repo pins an exact version via the `packageManager` field in `package.json`, so contributors should use that version to avoid install conflicts (check it with `grep packageManager package.json`, or activate it via Corepack with `corepack prepare bun@<version> --activate`).
+
 3. Set up environment variables:
 
 ```bash

From 5b7fd6f64fe6adc833d2c1e60268c8105cd099a9 Mon Sep 17 00:00:00 2001
From: iza <59828082+izadoesdev@users.noreply.github.com>
Date: Tue, 25 Aug 2026 23:37:29 +0300
Subject: [PATCH 3/3] docs: fix bun upgrade guidance

---
 CONTRIBUTING.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index ba95fa133..43362c288 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -18,14 +18,14 @@ git clone https://github.com/databuddy-analytics/Databuddy.git
 cd databuddy
 ```
 
-2. Install dependencies (requires Bun ≥ 1.2.0 — run `bun --version` to check, upgrade at https://bun.sh if needed):
+2. Install dependencies (requires Bun 1.2.0+, check with `bun --version`):
 
 ```bash
 bun install
 ```
 
 > [!NOTE]
-> Bun ≥ 1.2.0 is only the minimum required for `catalog:` protocol support. The repo pins an exact version via the `packageManager` field in `package.json`, so contributors should use that version to avoid install conflicts (check it with `grep packageManager package.json`, or activate it via Corepack with `corepack prepare bun@<version> --activate`).
+> Bun 1.2.0 is the minimum for `catalog:` dependency support. The repo pins an exact version in the `packageManager` field of `package.json`; match it with `bun upgrade` or by installing that version from https://bun.sh.
 
 3. Set up environment variables: