docs: improve discoverability of forgot password reset instructions

components/troubleshooting-flow.tsx

@@ -84,12 +84,13 @@ const troubleshootingPaths: TroubleshootingPath[] = [
       'Update Codex and the extension to the latest version.',
       'Restart the application or reload the editor window.',
       'Confirm your password meets the requirements.',
-      'Use password reset if you already created an account.',
+      'Use the Forgot Password option on the login screen (detailed guide available).',
       'Make sure the app has the permissions it requests.',
       'Check your network if the issue involves sign-in or AI access.',
       'Check the Codex Status page (status.codexeditor.com) to see if the servers are currently down.',
     ],
     docs: [
+      { title: 'Forgot Password', href: '/docs/getting-started/forgot-password' },
       { title: 'Initial Setup', href: '/docs/getting-started/initial-setup' },
       { title: 'FAQ', href: '/docs/faq' },
       { title: 'Codex Status', href: 'https://status.codexeditor.com' },

content/docs/faq.mdx

@@ -304,7 +304,11 @@ Yes. Projects are stored locally on your device, allowing for offline work. Chan
 
 ### I forgot my password. How do I reset it?
 
-Use the password reset option on the login screen. This is why it's important to use a real email address during [registration](/docs/getting-started/initial-setup).
+See the full step-by-step guide:
+
+**[Forgot Your Password →](/docs/getting-started/forgot-password)**
+
+Use the **Forgot Password** option on the login screen. This is why it's important to use a real email address during [registration](/docs/getting-started/initial-setup).
 
 ---
 

content/docs/getting-started/forgot-password.mdx

@@ -0,0 +1,70 @@
+---
+title: Forgot Your Password
+description: "Reset your Codex Editor password if you've forgotten it. Quick guide for the login screen reset flow."
+---
+
+# Forgot Your Password?
+
+If you can't remember your password, use the **Forgot Password** flow directly from the Codex login screen. This is the fastest way to regain access.
+
+## Reset Your Password (Step by Step)
+
+1. **Open the login screen**
+   - Launch Codex Editor
+   - If you're already logged in, log out first (or restart the app to reach the login screen)
+
+2. **Click "Forgot Password"**
+   - On the login screen, look for and click the **Forgot Password** option
+
+3. **Enter your registered email**
+   - Use the exact email address you used when you created your account
+
+4. **Check your email**
+   - Look in your inbox for a password reset email from Codex
+   - **Also check spam, junk, and promotions folders**
+
+5. **Click the reset link**
+   - Open the email and click the password reset link (the link expires after some time)
+
+6. **Create a new password**
+   - Must be at least **15 characters** long
+   - Must contain at least one **uppercase** letter and one **lowercase** letter
+   - Confirm the new password
+
+7. **Log in**
+   - Return to the login screen
+   - Enter your **username** (case sensitive) or **email address**
+   - Enter your new password
+
+## Critical Requirements
+
+<Callout type="warning">
+**You must have used a real email address during registration.**
+
+Fake or temporary emails cannot receive password reset links. This is why the registration screen strongly warns you to use a real or reliable email.
+</Callout>
+
+- Usernames are **case sensitive** — double-check capitalization if login fails after reset.
+- You can also use your registered **email address** in the username field to log in.
+
+## Didn't Receive the Reset Email?
+
+- Wait 2–5 minutes after requesting the reset.
+- Search your entire email (including spam) for "Codex", "password", or "reset".
+- Request the reset link again — you can do this multiple times.
+- Make sure you're entering the **exact email** used at registration.
+
+If you still cannot receive or complete the reset:
+
+- Go to the **[Troubleshooting guide](/docs/troubleshooting)** and choose **"I cannot log in or finish setup"**.
+- Or contact support on [Discord](https://discord.gg/6kVJTEXYEp) with details of what you've tried.
+
+## Related Guides
+
+- [Initial Setup & Registration](/docs/getting-started/initial-setup) — Full account creation and login instructions
+- [Frequently Asked Questions](/docs/faq) — Other common account questions
+- [Troubleshooting](/docs/troubleshooting) — Guided support flow for login problems
+
+---
+
+**Tip:** Write down or securely store your username and the email you used for registration. This makes future password resets much easier.

content/docs/getting-started/initial-setup.mdx

@@ -64,6 +64,11 @@ When you need to log in manually:
    - Your account password
 3. **Click Login**: Submit your credentials to access your account
 
+<Callout type="info" title="Forgot your password?">
+Forgot your password? Use the **Forgot Password** option on the login screen.  
+See the dedicated guide: **[Reset Forgotten Password →](/docs/getting-started/forgot-password)**
+</Callout>
+
 ## Account Security Best Practices
 
 ### Password Guidelines
@@ -147,7 +152,7 @@ After registering, Codex logs you in automatically. You should not need to log i
 1. Enter your **username** (case sensitive) or the **email address** you used to register.
 2. Enter your password.
 3. If you see an error message, note the exact text. Complete the [Troubleshooting guide](/docs/troubleshooting) support form and paste the generated template into [Discord](https://discord.gg/6kVJTEXYEp).
-4. If you forgot your password, use the **Forgot Password** option on the login screen. Check your spam folder for the reset email.
+4. If you forgot your password, use the **[Forgot Password](/docs/getting-started/forgot-password)** flow on the login screen. Check your spam folder for the reset email.
 
 #### Registration is not working
 
@@ -166,7 +171,7 @@ If registration still fails, complete the [Troubleshooting guide](/docs/troubles
 #### Common account issues
 
 - **Username already taken**: Try variations of your preferred username, or add numbers or underscores to make it unique.
-- **Email already registered**: You may already have an account. Try the password reset option if you have forgotten your credentials.
+- **Email already registered**: You may already have an account. Use the **[Forgot Password](/docs/getting-started/forgot-password)** flow if you need to regain access.
 
 ---
 

content/docs/getting-started/meta.json

@@ -2,6 +2,7 @@
   "title": "Getting Started",
   "pages": [
     "download-codex",
-    "initial-setup"
+    "initial-setup",
+    "forgot-password"
   ]
 }