From d71943881da41a76f49b468a3b4855372cb8dd35 Mon Sep 17 00:00:00 2001 From: Aadesh Kheria Date: Mon, 6 Apr 2026 16:17:30 -0700 Subject: [PATCH 1/4] welcome page changes --- docs-mintlify/index.mdx | 134 +++++++++++++++++++++++++++------------- 1 file changed, 92 insertions(+), 42 deletions(-) diff --git a/docs-mintlify/index.mdx b/docs-mintlify/index.mdx index 8d5ff04646..2c6b082f92 100644 --- a/docs-mintlify/index.mdx +++ b/docs-mintlify/index.mdx @@ -3,7 +3,7 @@ title: "Welcome" description: "Stack Auth documentation for setup, components, SDK usage, and REST APIs." --- -
+
-

Explore the Docs

+

Navigate Through Our Docs

- Jump into the part of the platform that matches how you are integrating Stack Auth. + Start at the top and work your way down, or jump straight to the section you need.

- - - Installation, environment setup, and the first authentication flow. - - - Prebuilt React and Next.js UI for sign-in, sign-up, account settings, and team switching. - - - Hooks, objects, and types for working with users, teams, projects, and sessions. - - - HTTP APIs for client, server, admin, and webhook integrations in any stack. - - -
+

Recommended Order

-
-
-

Common Tasks

-

- Start from practical guides for the features teams tend to configure first. -

+
+ {/* Getting Started */} +
+
+ Getting Started +

First-time setup, install the SDK, get auth running in minutes.

+ +
+ + {/* Components */} +
+
+ Components +

Drop-in UI for sign-in, sign-up, account settings, and team switching.

+ +
+ + {/* SDK Reference */} +
+
+ SDK Reference +

Hooks, types, and objects for reading and writing user data in code.

+ +
+
+ + {/* Branch divider */} +
+
+ Then pick your path +
+
+ + {/* Branching cards */} +
+
+ Going Further +

Customization, dark mode, i18n, teams, permissions.

+ +
+
+ Apps +

OAuth, emails, payments, webhooks, API keys.

+ +
+
+ REST API +

HTTP endpoints for any backend or language.

+ +
+

Explore Apps

+ - - Set up publishable, secret, user, and team API keys. - - - Define roles and permission models for projects and teams. - - - Trigger downstream systems from auth, user, and team events. - - - Understand how Stack Auth fits into your server architecture. - - - Connect Stack Auth docs and workflows to AI-enabled development tools. - - - Check answers to common setup, integration, and product questions. - + + + + + + + + + + +
From 830dc9c6673b7ec87594cf35bad8a2722f894995 Mon Sep 17 00:00:00 2001 From: Aadesh Kheria Date: Tue, 7 Apr 2026 11:17:30 -0700 Subject: [PATCH 2/4] fixed broken links --- docs-mintlify/index.mdx | 76 ++++++++++++++++++++--------------------- 1 file changed, 38 insertions(+), 38 deletions(-) diff --git a/docs-mintlify/index.mdx b/docs-mintlify/index.mdx index ae7b672e60..2d9f280faf 100644 --- a/docs-mintlify/index.mdx +++ b/docs-mintlify/index.mdx @@ -83,37 +83,37 @@ sidebarTitle: "Overview" {/* Getting Started */}
- Getting Started + Getting Started

First-time setup, install the SDK, get auth running in minutes.

{/* Components */}
- Components + Components

Drop-in UI for sign-in, sign-up, account settings, and team switching.

{/* SDK Reference */}
- SDK Reference + SDK Reference

Hooks, types, and objects for reading and writing user data in code.

@@ -128,30 +128,30 @@ sidebarTitle: "Overview" {/* Branching cards */}
- Going Further -

Customization, dark mode, i18n, teams, permissions.

+ Going Further +

Stack App configuration, backend integration, local development, metadata.

- Apps -

OAuth, emails, payments, webhooks, API keys.

+ Apps +

Authentication, emails, payments, webhooks, API keys.

- REST API + REST API

HTTP endpoints for any backend or language.

@@ -159,17 +159,17 @@ sidebarTitle: "Overview"

Explore Apps

- - - - - - - - - - - + + + + + + + + + + +
From 95a8b81a5c46d7ea5d19b882854e30f6b806390d Mon Sep 17 00:00:00 2001 From: Aadesh Kheria Date: Wed, 8 Apr 2026 09:58:07 -0700 Subject: [PATCH 3/4] pr comments --- docs-mintlify/index.mdx | 64 +++++++++++++++++++++++++---------------- 1 file changed, 39 insertions(+), 25 deletions(-) diff --git a/docs-mintlify/index.mdx b/docs-mintlify/index.mdx index 2d9f280faf..990b63d95d 100644 --- a/docs-mintlify/index.mdx +++ b/docs-mintlify/index.mdx @@ -4,6 +4,22 @@ description: "Stack Auth documentation for setup, components, SDK usage, and RES sidebarTitle: "Overview" --- +export const SectionLink = ({ href, children }) => ( + {children} +); + +export const ChipLink = ({ href, children }) => ( + {children} +); + +export const CardTitle = ({ href, children }) => ( + {children} +); + +export const CardChip = ({ href, children }) => ( + {children} +); +
- Getting Started + Getting Started

First-time setup, install the SDK, get auth running in minutes.

- Setup - Users - AI Integration - Production + Setup + Users + AI Integration + Production
{/* Components */}
- Components + Components

Drop-in UI for sign-in, sign-up, account settings, and team switching.

- SignIn / SignUp - UserButton - StackProvider + SignIn / SignUp + UserButton
{/* SDK Reference */}
- SDK Reference + SDK Reference

Hooks, types, and objects for reading and writing user data in code.

- useUser - Types - StackApp + useUser + Types + StackApp
@@ -128,30 +143,29 @@ sidebarTitle: "Overview" {/* Branching cards */}
- Going Further + Going Further

Stack App configuration, backend integration, local development, metadata.

- Stack App - Local dev - Backend + Stack App + Local dev + Backend
- Apps + Apps

Authentication, emails, payments, webhooks, API keys.

- Auth - Emails - Payments + Auth + Emails + Payments
- REST API + REST API

HTTP endpoints for any backend or language.

- Client API - Server API - Webhooks + REST API + Webhooks
From cd7f1919a35d0f7b50b4c682f8c4dfbc42fa0aca Mon Sep 17 00:00:00 2001 From: Aadesh Kheria Date: Wed, 8 Apr 2026 17:29:47 -0700 Subject: [PATCH 4/4] removed button --- docs-mintlify/index.mdx | 1 - 1 file changed, 1 deletion(-) diff --git a/docs-mintlify/index.mdx b/docs-mintlify/index.mdx index 990b63d95d..00e7629f06 100644 --- a/docs-mintlify/index.mdx +++ b/docs-mintlify/index.mdx @@ -116,7 +116,6 @@ export const CardChip = ({ href, children }) => (

Drop-in UI for sign-in, sign-up, account settings, and team switching.

SignIn / SignUp - UserButton