[PR #8190] [MERGED] docs: make OAuth proxy content clearer #24704

Closed
opened 2026-04-15 22:31:20 -05:00 by GiteaMirror · 0 comments
Owner

📋 Pull Request Information

Original PR: https://github.com/better-auth/better-auth/pull/8190
Author: @bytaesu
Created: 2/27/2026
Status: Merged
Merged: 3/12/2026
Merged by: @bytaesu

Base: canaryHead: cursor/oauth-proxy-docs-clarity-1e85


📝 Commits (5)

  • 5eb77ef docs: improve OAuth Proxy plugin documentation clarity
  • e5037dc Merge branch 'canary' into cursor/oauth-proxy-docs-clarity-1e85
  • e990543 Merge branch 'canary' into cursor/oauth-proxy-docs-clarity-1e85
  • c4d1904 docs: simplify description
  • 76b15d8 docs: clearer guide

📊 Changes

1 file changed (+43 additions, -25 deletions)

View changed files

📝 docs/content/docs/plugins/oauth-proxy.mdx (+43 -25)

📄 Description

Update OAuth Proxy documentation to remove inferred details, add critical configuration, and improve clarity based on the ba-oauth-proxy-example.

The previous documentation included details like currentURL and redirectURI that are internally inferred by the plugin, leading to potential confusion or conflicts. This update removes these unnecessary specifications and adds crucial information regarding trustedOrigins for cross-origin redirects and the importance of a shared BETTER_AUTH_SECRET for payload encryption across environments. The update also ensures the documentation remains platform-agnostic.


Slack Thread

Open in Web Open in Cursor 


🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.

## 📋 Pull Request Information **Original PR:** https://github.com/better-auth/better-auth/pull/8190 **Author:** [@bytaesu](https://github.com/bytaesu) **Created:** 2/27/2026 **Status:** ✅ Merged **Merged:** 3/12/2026 **Merged by:** [@bytaesu](https://github.com/bytaesu) **Base:** `canary` ← **Head:** `cursor/oauth-proxy-docs-clarity-1e85` --- ### 📝 Commits (5) - [`5eb77ef`](https://github.com/better-auth/better-auth/commit/5eb77ef75ffd6241d54edfdfd2d2b432d937b21a) docs: improve OAuth Proxy plugin documentation clarity - [`e5037dc`](https://github.com/better-auth/better-auth/commit/e5037dcf92dbb558d70bac50540e4fc6cd6e5049) Merge branch 'canary' into cursor/oauth-proxy-docs-clarity-1e85 - [`e990543`](https://github.com/better-auth/better-auth/commit/e990543e9366beb5f84b6fbb72c47ee120dbdf07) Merge branch 'canary' into cursor/oauth-proxy-docs-clarity-1e85 - [`c4d1904`](https://github.com/better-auth/better-auth/commit/c4d19049be469dd6c85607219b5b6ab98b05acbc) docs: simplify description - [`76b15d8`](https://github.com/better-auth/better-auth/commit/76b15d81928caaf41dec2f615e41993a49b5c9e9) docs: clearer guide ### 📊 Changes **1 file changed** (+43 additions, -25 deletions) <details> <summary>View changed files</summary> 📝 `docs/content/docs/plugins/oauth-proxy.mdx` (+43 -25) </details> ### 📄 Description Update OAuth Proxy documentation to remove inferred details, add critical configuration, and improve clarity based on the `ba-oauth-proxy-example`. The previous documentation included details like `currentURL` and `redirectURI` that are internally inferred by the plugin, leading to potential confusion or conflicts. This update removes these unnecessary specifications and adds crucial information regarding `trustedOrigins` for cross-origin redirects and the importance of a shared `BETTER_AUTH_SECRET` for payload encryption across environments. The update also ensures the documentation remains platform-agnostic. --- [Slack Thread](https://betterauth.slack.com/archives/C0A8B5BARUK/p1772212493356869?thread_ts=1772212493.356869&cid=C0A8B5BARUK) <p><a href="https://cursor.com/agents/bc-786c5f91-39ae-5abb-a2cd-adfdfc13a851"><picture><source media="(prefers-color-scheme: dark)" srcset="https://cursor.com/assets/images/open-in-web-dark.png"><source media="(prefers-color-scheme: light)" srcset="https://cursor.com/assets/images/open-in-web-light.png"><img alt="Open in Web" width="114" height="28" src="https://cursor.com/assets/images/open-in-web-dark.png"></picture></a>&nbsp;<a href="https://cursor.com/background-agent?bcId=bc-786c5f91-39ae-5abb-a2cd-adfdfc13a851"><picture><source media="(prefers-color-scheme: dark)" srcset="https://cursor.com/assets/images/open-in-cursor-dark.png"><source media="(prefers-color-scheme: light)" srcset="https://cursor.com/assets/images/open-in-cursor-light.png"><img alt="Open in Cursor" width="131" height="28" src="https://cursor.com/assets/images/open-in-cursor-dark.png"></picture></a>&nbsp;</p> --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>
GiteaMirror added the pull-request label 2026-04-15 22:31:20 -05:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: github-starred/better-auth#24704