diff --git a/changelog.d/fixes/8284-provider-docs-link.md b/changelog.d/fixes/8284-provider-docs-link.md
new file mode 100644
index 0000000000..771bf7c262
--- /dev/null
+++ b/changelog.d/fixes/8284-provider-docs-link.md
@@ -0,0 +1 @@
+- **fix(providers):** the Providers page Learn more button now opens the maintained GitHub documentation instead of the retired `docs.omniroute.io` page ([#8284](https://github.com/diegosouzapw/OmniRoute/pull/8284)) - thanks @KaynXu
diff --git a/src/app/(dashboard)/dashboard/providers/page.tsx b/src/app/(dashboard)/dashboard/providers/page.tsx
index 3485111544..678356b384 100644
--- a/src/app/(dashboard)/dashboard/providers/page.tsx
+++ b/src/app/(dashboard)/dashboard/providers/page.tsx
@@ -828,7 +828,7 @@ export default function ProvidersPage() {
                 {providerText(t, "onboardingWizard", "Provider Onboarding Wizard")}
               </Button>
               <a
-                href="https://docs.omniroute.io/providers"
+                href="https://github.com/diegosouzapw/OmniRoute#-documentation"
                 target="_blank"
                 rel="noopener noreferrer"
                 className="inline-flex items-center gap-1.5 px-4 py-2 text-sm font-medium rounded-lg border border-border text-text-muted hover:text-text-main hover:bg-bg-subtle transition-colors"
diff --git a/tests/unit/provider-learn-more-link.test.ts b/tests/unit/provider-learn-more-link.test.ts
new file mode 100644
index 0000000000..839454428e
--- /dev/null
+++ b/tests/unit/provider-learn-more-link.test.ts
@@ -0,0 +1,28 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+
+const here = dirname(fileURLToPath(import.meta.url));
+const repoRoot = join(here, "..", "..");
+const providersPage = readFileSync(
+  join(repoRoot, "src/app/(dashboard)/dashboard/providers/page.tsx"),
+  "utf8"
+);
+
+test("provider Learn more link uses the maintained documentation entry point", () => {
+  assert.match(
+    providersPage,
+    /href="https:\/\/github\.com\/diegosouzapw\/OmniRoute#-documentation"/,
+    "the provider help CTA should open the maintained GitHub documentation section"
+  );
+});
+
+test("provider Learn more link does not use the retired documentation host", () => {
+  assert.doesNotMatch(
+    providersPage,
+    /https:\/\/docs\.omniroute\.io\/providers/,
+    "docs.omniroute.io/providers is no longer reachable"
+  );
+});