diff --git a/docs-mintlify/index.mdx b/docs-mintlify/index.mdx
index f28ec3b57d..00e7629f06 100644
--- a/docs-mintlify/index.mdx
+++ b/docs-mintlify/index.mdx
@@ -4,7 +4,23 @@ 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}
+);
+
+
-
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.
-
-
- Configure prebuilt React and Next.js auth UI, providers, and handlers.
-
-
- 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.
+
+ Setup
+ Users
+ AI Integration
+ Production
+
+
+
+ {/* Components */}
+
+
+
Components
+
Drop-in UI for sign-in, sign-up, account settings, and team switching.
+
+ SignIn / SignUp
+
+
+
+ {/* SDK Reference */}
+
+
+
SDK Reference
+
Hooks, types, and objects for reading and writing user data in code.
+
+ useUser
+ Types
+ StackApp
+
+
+
+
+ {/* Branch divider */}
+
+
+
Then pick your path
+
+
+
+ {/* Branching cards */}
+
+
+
Going Further
+
Stack App configuration, backend integration, local development, metadata.
+
+ Stack App
+ Local dev
+ Backend
+
+
+
+
Apps
+
Authentication, emails, payments, webhooks, API keys.
+
+ Auth
+ Emails
+ Payments
+
+
+
+
REST API
+
HTTP endpoints for any backend or language.
+
+ REST API
+ Webhooks
+
+
+
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.
-
+
+
+
+
+
+
+
+
+
+
+