From b2a041c7c487c9c169eafc513bfecec154cf4dd7 Mon Sep 17 00:00:00 2001
From: SergeantPanda <chester.cullen@gmail.com>
Date: Fri, 14 Nov 2025 15:18:57 -0600
Subject: [PATCH] Enhancement: Add forgot password link to login form with
 instructions on how to properly reset a forgotten password.

---
 frontend/src/components/forms/LoginForm.jsx | 56 +++++++++++++++++++++
 1 file changed, 56 insertions(+)

diff --git a/frontend/src/components/forms/LoginForm.jsx b/frontend/src/components/forms/LoginForm.jsx
index 9c4dd57a..6ccf9e81 100644
--- a/frontend/src/components/forms/LoginForm.jsx
+++ b/frontend/src/components/forms/LoginForm.jsx
@@ -12,6 +12,9 @@ import {
   Image,
   Group,
   Divider,
+  Modal,
+  Anchor,
+  Code,
 } from '@mantine/core';
 import logo from '../../assets/logo.png';
 
@@ -23,6 +26,7 @@ const LoginForm = () => {
 
   const navigate = useNavigate(); // Hook to navigate to other routes
   const [formData, setFormData] = useState({ username: '', password: '' });
+  const [forgotPasswordOpened, setForgotPasswordOpened] = useState(false);
 
   useEffect(() => {
     if (isAuthenticated) {
@@ -98,9 +102,61 @@ const LoginForm = () => {
             <Button type="submit" mt="sm" fullWidth>
               Login
             </Button>
+
+            <Group justify="flex-end">
+              <Anchor
+                size="sm"
+                component="button"
+                type="button"
+                onClick={(e) => {
+                  e.preventDefault();
+                  setForgotPasswordOpened(true);
+                }}
+              >
+                Forgot password?
+              </Anchor>
+            </Group>
           </Stack>
         </form>
       </Paper>
+
+      <Modal
+        opened={forgotPasswordOpened}
+        onClose={() => setForgotPasswordOpened(false)}
+        title="Reset Your Password"
+        centered
+      >
+        <Stack spacing="md">
+          <Text>
+            To reset your password, your administrator needs to run a Django
+            management command:
+          </Text>
+          <div>
+            <Text weight={500} size="sm" mb={8}>
+              If running with Docker:
+            </Text>
+            <Code block>
+              docker exec &lt;container_name&gt; python manage.py changepassword
+              &lt;username&gt;
+            </Code>
+          </div>
+          <div>
+            <Text weight={500} size="sm" mb={8}>
+              If running locally:
+            </Text>
+            <Code block>python manage.py changepassword &lt;username&gt;</Code>
+          </div>
+          <Text size="sm" color="dimmed">
+            The command will prompt for a new password. Replace
+            <code>&lt;container_name&gt;</code> with your Docker container name
+            and <code>&lt;username&gt;</code> with the account username.
+          </Text>
+          <Text size="sm" color="dimmed" italic>
+            Please contact your system administrator to perform a password
+            reset.
+          </Text>
+        </Stack>
+      </Modal>
     </Center>
   );
 };