stack/docs/templates
Zai Shi a8fe2aa6ed
Add docs link to provider pop up, add better GitHub docs (#829)
<img width="474" height="362" alt="image"
src="https://github.com/user-attachments/assets/01a89abb-9fd3-482e-8c09-b1de23296287"
/>

<!-- ELLIPSIS_HIDDEN -->

----

> [!IMPORTANT]
> Add documentation link to provider pop-up and improve GitHub setup
instructions with tabs for OAuth and GitHub apps.
> 
>   - **UI Changes**:
> - Add a documentation link to the provider pop-up in `providers.tsx`
for detailed provider setup.
> - Display a note for GitHub apps requiring public status and read-only
email permissions in `providers.tsx`.
>   - **Documentation**:
> - Update `github.mdx` to include tabs for OAuth App and GitHub App
setup instructions.
> - Add detailed steps for creating GitHub Apps, including enabling
read-only email permissions and making the app public.
> 
> <sup>This description was created by </sup>[<img alt="Ellipsis"
src="https://img.shields.io/badge/Ellipsis-blue?color=175173">](https://www.ellipsis.dev?ref=stack-auth%2Fstack-auth&utm_source=github&utm_medium=referral)<sup>
for 484cb1c9c3. You can
[customize](https://app.ellipsis.dev/stack-auth/settings/summaries) this
summary. It will automatically update as commits are pushed.</sup>

<!-- ELLIPSIS_HIDDEN -->

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **New Features**
* Show an informational note for GitHub OAuth providers when "shared" is
not selected, clarifying the app must be public and have read-only email
permission.
* Add a small outlined link-style button beneath provider settings that
opens the provider's documentation in a new tab (includes a right-arrow
cue).

* **Documentation**
* Update GitHub auth docs with tabs separating OAuth App and GitHub App
setup steps for clearer guidance.

* **Notes**
  * No public API changes; visual/UI and docs updates only.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> Adds a docs link and GitHub app note to the provider dialog, and
updates GitHub auth docs with tabbed OAuth vs GitHub App setup steps.
> 
> - **Dashboard UI (`apps/.../providers.tsx`)**:
> - Add "See full documentation" link button pointing to
provider-specific docs.
> - Show GitHub-specific note when not using shared keys: app must be
public and have read-only email permission.
> - **Docs (`docs/templates/concepts/auth-providers/github.mdx`)**:
>   - Introduce tabs separating OAuth App and GitHub App setup.
> - Add steps for GitHub App: enable read-only email permission and make
app public.
> 
> <sup>Written by [Cursor
Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit
c09974a7fd. This will update automatically
on new commits. Configure
[here](https://cursor.com/dashboard?tab=bugbot).</sup>
<!-- /CURSOR_SUMMARY -->

---------

Co-authored-by: Konsti Wohlwend <n2d4xc@gmail.com>
Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>
Co-authored-by: Bilal Godil <bg2002@gmail.com>
2025-11-17 16:20:26 -08:00
..
components Init stack more args (#892) 2025-09-11 10:20:44 -07:00
concepts Add docs link to provider pop up, add better GitHub docs (#829) 2025-11-17 16:20:26 -08:00
customization Rename offer to product, offer group to product catalog (#914) 2025-10-04 02:28:28 -07:00
getting-started [Docs][Util][Content] - refactor docs to single source (#919) 2025-10-20 12:42:46 -05:00
others Customizable ports (#962) 2025-10-20 15:24:47 -07:00
rest-api Rename offer to product, offer group to product catalog (#914) 2025-10-04 02:28:28 -07:00
sdk [Docs][Util][Content] - refactor docs to single source (#919) 2025-10-20 12:42:46 -05:00
snippets New docs (#698) 2025-06-20 13:30:01 -07:00
faq.mdx Docs updates (#753) 2025-07-11 10:00:02 -07:00
meta.json [Docs][Content] - MCP installation instructions (#915) 2025-10-10 13:31:48 -05:00
overview.mdx Rename offer to product, offer group to product catalog (#914) 2025-10-04 02:28:28 -07:00