From 7cd76ccdf7e0cc7bb5037f59baa0c2467aa37627 Mon Sep 17 00:00:00 2001
From: vanshikadahaliya <vanshikadahaliya@gmail.com>
Date: Wed, 17 Dec 2025 12:39:39 +0530
Subject: [PATCH 1/3] docs: document optional uv setup and Windows limitations

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

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 125f04bb87..66b5664c1c 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -113,6 +113,27 @@ Before you start contributing, you'll need to set up your development environmen
 
 ### Python Virtual Environment Setup
 
+
+### Optional: Python Virtual Environment Setup using `uv`
+
+BLT can also be set up using [`uv`](https://github.com/astral-sh/uv), a fast Python package manager
+and virtual environment tool. This is an **optional** alternative to the Poetry-based setup
+described above.
+
+This option is useful for contributors who prefer faster dependency resolution and installation.
+
+#### Install `uv`
+
+> ⚠️ Note (Windows):  
+> On some Windows setups, `uv` may fail to auto-detect Python installations
+> due to registry or PATH resolution issues. In such cases, explicitly
+> specifying the Python interpreter or using Docker/Poetry is recommended.
+
+
+```bash
+pip install uv
+
+
 1. Install Python 3.11.2 (using pyenv or another tool):
 
    ```bash

From be7f162c57e61b4855b288133cb9682f870bb37c Mon Sep 17 00:00:00 2001
From: vanshikadahaliya <vanshikadahaliya@gmail.com>
Date: Wed, 17 Dec 2025 14:12:49 +0530
Subject: [PATCH 2/3] docs: fix uv install code block and add setup steps

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

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 66b5664c1c..896ea66fd0 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -132,6 +132,7 @@ This option is useful for contributors who prefer faster dependency resolution a
 
 ```bash
 pip install uv
+```
 
 
 1. Install Python 3.11.2 (using pyenv or another tool):

From 424c50cffdb45f47c68c5e5ea30f3664444a8603 Mon Sep 17 00:00:00 2001
From: vanshikadahaliya <vanshikadahaliya@gmail.com>
Date: Wed, 17 Dec 2025 14:25:05 +0530
Subject: [PATCH 3/3] docs: add uv usage steps

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

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 896ea66fd0..cf1fd1e50d 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -134,6 +134,21 @@ This option is useful for contributors who prefer faster dependency resolution a
 pip install uv
 ```
 
+#### Set up the BLT project using `uv`
+
+From the project root, run:
+
+```bash
+uv sync
+
+To start the development server:
+
+uv run python manage.py migrate
+uv run python manage.py runserver
+
+Open your browser at:
+http://localhost:8000
+
 
 1. Install Python 3.11.2 (using pyenv or another tool):