From 973ea650e60a407f024cfce9ef58d71f73a2b05b Mon Sep 17 00:00:00 2001
From: Rishi <maharishi459@gmail.com>
Date: Thu, 1 Jan 2026 20:22:52 +0530
Subject: [PATCH 1/4] fix(docker): add default USER_ID and GROUP_ID for Windows
 compatibility

---
 Dockerfile | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Dockerfile b/Dockerfile
index 933ce9d8..2a825baf 100644
--- a/Dockerfile
+++ b/Dockerfile
@@ -19,8 +19,8 @@ RUN apt-get update && apt-get install -y gettext
 ###############################################################################
 FROM base AS dev
 
-ARG USER_ID
-ARG GROUP_ID
+ARG USER_ID=1000
+ARG GROUP_ID=1000
 
 RUN groupadd -o -g $GROUP_ID -r usergrp
 RUN useradd -o -m -u $USER_ID -g $GROUP_ID user

From 91b4ee175284804ede8c26c6358368c71eef0581 Mon Sep 17 00:00:00 2001
From: Rishi <maharishi459@gmail.com>
Date: Thu, 1 Jan 2026 20:25:38 +0530
Subject: [PATCH 2/4] fix(i18n): fixed English language code which was causing
 reset on reload

---
 portal/settings.py | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/portal/settings.py b/portal/settings.py
index 0df1f09f..58cd80e7 100644
--- a/portal/settings.py
+++ b/portal/settings.py
@@ -161,11 +161,11 @@
 # Internationalization
 # https://docs.djangoproject.com/en/5.1/topics/i18n/
 
-LANGUAGE_CODE = "en-us"
+LANGUAGE_CODE = "en"
 
 LANGUAGES = (
     ("pt-br", "Português"),
-    ("en-us", "English"),
+    ("en", "English"),
 )
 
 TIME_ZONE = "UTC"

From 1d5c78a14dd6c133024f5da4e8d16438d99d646f Mon Sep 17 00:00:00 2001
From: Rishi <maharishi459@gmail.com>
Date: Thu, 1 Jan 2026 20:28:18 +0530
Subject: [PATCH 3/4] fix(i18n): reorder languages to show English first as
 default - by default page loads in eng

---
 portal/settings.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/portal/settings.py b/portal/settings.py
index 58cd80e7..766bcc1d 100644
--- a/portal/settings.py
+++ b/portal/settings.py
@@ -164,8 +164,8 @@
 LANGUAGE_CODE = "en"
 
 LANGUAGES = (
-    ("pt-br", "Português"),
     ("en", "English"),
+    ("pt-br", "Português"),
 )
 
 TIME_ZONE = "UTC"

From 689555e8f0cd60047d06b956773775a88e5b14c7 Mon Sep 17 00:00:00 2001
From: Rishi <maharishi459@gmail.com>
Date: Fri, 2 Jan 2026 18:23:04 +0530
Subject: [PATCH 4/4] docs: add Windows-specific setup instructions

---
 docs/developer/setup.md | 49 +++++++++++++++++++++++++++++++++++++----
 1 file changed, 45 insertions(+), 4 deletions(-)

diff --git a/docs/developer/setup.md b/docs/developer/setup.md
index c4730fc0..bdb9f51a 100644
--- a/docs/developer/setup.md
+++ b/docs/developer/setup.md
@@ -18,7 +18,7 @@ Have these installed first before continuing further.
 
 - Docker
 - Docker compose
-- GNU Make
+- GNU Make (optional, but recommended) - see [Windows note](#windows-note) if you don't have it
 - GitHub CLI (optional, but recommended) https://cli.github.com/
 
 ### Starting the local env
@@ -41,9 +41,21 @@ Have these installed first before continuing further.
 
 3. Start the local environment:
 
-```sh
-make serve
-```
+=== "With Make"
+
+    ```sh
+    make serve
+    ```
+
+=== "Without Make (Windows)"
+
+    ```sh
+    docker compose build --force-rm web
+    docker compose run --rm web python manage.py collectstatic --noinput --clear
+    docker compose run --rm web python manage.py createcachetable
+    docker compose run --rm web python manage.py migrate
+    docker compose up --remove-orphans -d
+    ```
 
 4. Open the browser and go to <http://localhost:8000/> to see the app running.
 
@@ -275,3 +287,32 @@ If you see the error `Cairo library was not found`, try the following instructio
 1. [MKDocs material image processing Docs](https://squidfunk.github.io/mkdocs-material/plugins/requirements/image-processing/?h=cairo#troubleshooting).
 
 2. Check if the `Cairo libraries` are listed in ```/opt/homebrew/lib``` folder. If not, follow the instructions [on this page](https://github.com/squidfunk/mkdocs-material/issues/5121).
+
+## Windows Note
+
+### Make command not available
+
+On Windows, the `make` command from the Makefile may not be available by default. You have two options:
+
+**Option 1: Install Make** (recommended for future use)
+
+=== "Using Chocolatey"
+
+    ```powershell
+    choco install make
+    ```
+
+=== "Using winget"
+
+    ```powershell
+    winget install GnuWin32.Make
+    ```
+
+After installation, restart your terminal and `make serve` should work.
+
+**Option 2: Use Docker commands directly**
+
+If you don't want to install Make, you can run the Docker commands directly as shown in the "Without Make (Windows)" tab in the [Starting the local env](#starting-the-local-env) section above.
+
+Both approaches will set up your development environment successfully.
+````