[wip] reorging content and adding top-level sdk switching

docs/custom-flows/bot-sign-up-protection.mdx

@@ -5,7 +5,7 @@ description: Learn how to use the Smart Bot Protection widget in your custom sig
 
 # Smart bot sign-up protection
 
-<Callout type="warning">
+<Callout type="danger">
   The simplest way to take advantage of [Bot Protection](/docs/security/bot-protection) for your Sign ups is by using our all-in-one [`<SignUp />` component](/docs/components/authentication/sign-up). This page describes how to implement Bot Protection if you are rebuilding your Sign Up view entirely from scratch using Clerk.
 </Callout>
 

docs/custom-flows/email-sms-otp.mdx

@@ -5,7 +5,7 @@ description: Learn how build a custom email or SMS one time code (OTP) authentic
 
 # Build a custom email or SMS OTP authentication flow
 
-<Callout type="warning">
+<Callout type="danger">
   This guide is for users who want to build a *custom* user interface using the Clerk API. To authenticate users with one-time passwords using a *prebuilt* UI, you should use Clerk's [Account Portal pages](/docs/account-portal/overview) or [prebuilt components](/docs/components/overview).
 </Callout>
 

docs/custom-flows/multi-session-applications.mdx

@@ -5,7 +5,7 @@ description: Learn how to use the Clerk API to add multi-session handling to you
 
 # Build a custom multi-session flow
 
-<Callout type="warning">
+<Callout type="danger">
   This guide is for users who want to build a *custom* user interface using the Clerk API. To implement multi-session handling with a *prebuilt* UI, you should use Clerk's [`<UserButton />`](/docs/components/user/user-button) component.
 </Callout>
 

docs/custom-flows/passkeys.mdx

@@ -5,7 +5,7 @@ description: Learn how to allow your users authenticate with passkeys with Clerk
 
 # Build a custom authentication flow using passkeys
 
-<Callout type="warning">
+<Callout type="danger">
 This guide is for users who want to build a *custom* user interface using the Clerk API. To authenticate users with passkeys using a *prebuilt* UI, you should use Clerk's [`<SignIn />`](/docs/components/authentication/sign-in) and [`<UserProfile />`](/docs/components/user/user-profile) components. See [the sign-in and sign-out options docs](/docs/authentication/configuration/sign-up-sign-in-options#passkeys) to learn more.
 </Callout>
 

docs/guides/index.mdx

@@ -0,0 +1,14 @@
+---
+title: Overview
+description: Guides covering how to build or work with parts of Clerk
+---
+
+# Clerk Guides
+
+The following guides will cover ways to configure or build your Clerk powered application. 
+
+## Guides
+
+* [Implement basic Role Based Access Control (RBAC) with metadata](/docs/guides/basic-rbac)
+* [Hide Personal Accounts and force organizations](/docs/guides/force-organizations)
+* [Migrating to Clerk from Auth.js](/docs/guides/authjs-migration)

docs/manifest.components.json

@@ -0,0 +1,226 @@
+{
+  "$schema": "./manifest.schema.json",
+  "navigation": [
+    [
+      {
+        "title": "Component Types",
+        "items": [
+          [
+            {
+              "title": "All in one",
+              "href": "/docs/components/overview",
+              "icon": "box"
+            },
+            {
+              "title": "Elements",
+              "tag": "(Beta)",
+              "href": "/docs/elements/overview",
+              "icon": "application-2"
+            }
+          ]
+        ]
+      },
+      {
+        "title": "Featured",
+        "items": [
+          [
+            {
+              "title": "`<ClerkProvider />`",
+              "href": "/docs/components/clerk-provider"
+            },
+            {
+              "title": "`<SignIn />`",
+              "href": "/docs/components/authentication/sign-in"
+            },
+            {
+              "title": "`<SignUp />`",
+              "href": "/docs/components/authentication/sign-up"
+            }
+          ]
+        ]
+      },
+      {
+        "title": "Component Reference",
+        "items": [
+          [
+            {
+              "title": "Authentication Components",
+              "collapse": true,
+              "items": [
+                [
+                  {
+                    "title": "`<SignIn />`",
+                    "href": "/docs/components/authentication/sign-in"
+                  },
+                  {
+                    "title": "`<SignUp />`",
+                    "href": "/docs/components/authentication/sign-up"
+                  }
+                ]
+              ]
+            },
+            {
+              "title": "User Components",
+              "collapse": true,
+              "items": [
+                [
+                  {
+                    "title": "`<UserButton />`",
+                    "href": "/docs/components/user/user-button"
+                  },
+                  {
+                    "title": "`<UserProfile />`",
+                    "href": "/docs/components/user/user-profile"
+                  }
+                ]
+              ]
+            },
+            {
+              "title": "Organization Components",
+              "collapse": true,
+              "items": [
+                [
+                  {
+                    "title": "`<CreateOrganization />`",
+                    "href": "/docs/components/organization/create-organization"
+                  },
+                  {
+                    "title": "`<OrganizationProfile />`",
+                    "href": "/docs/components/organization/organization-profile"
+                  },
+                  {
+                    "title": "`<OrganizationSwitcher />`",
+                    "href": "/docs/components/organization/organization-switcher"
+                  },
+                  {
+                    "title": "`<OrganizationList />`",
+                    "href": "/docs/components/organization/organization-list"
+                  }
+                ]
+              ]
+            },
+            {
+              "title": "Button Components",
+              "collapse": true,
+              "items": [
+                [
+                  {
+                    "title": "`<SignInButton />`",
+                    "href": "/docs/components/unstyled/sign-in-button"
+                  },
+                  {
+                    "title": "`<SignUpButton />`",
+                    "href": "/docs/components/unstyled/sign-up-button"
+                  },
+                  {
+                    "title": "`<SignOutButton />`",
+                    "href": "/docs/components/unstyled/sign-out-button"
+                  }
+                ]
+              ]
+            },
+            {
+              "title": "Control Components",
+              "collapse": true,
+              "items": [
+                [
+                  {
+                    "title": "`<AuthenticateWithRedirectCallback />`",
+                    "wrap": false,
+                    "href": "/docs/components/control/authenticate-with-callback"
+                  },
+                  {
+                    "title": "`<ClerkLoaded>`",
+                    "wrap": false,
+                    "href": "/docs/components/control/clerk-loaded"
+                  },
+                  {
+                    "title": "`<ClerkLoading>`",
+                    "wrap": false,
+                    "href": "/docs/components/control/clerk-loading"
+                  },
+                  {
+                    "title": "`<Protect>`",
+                    "wrap": false,
+                    "href": "/docs/components/protect"
+                  },
+                  {
+                    "title": "`<MultisessionAppSupport>`",
+                    "wrap": false,
+                    "href": "/docs/components/control/multi-session"
+                  },
+                  {
+                    "title": "`<RedirectToSignIn />`",
+                    "wrap": false,
+                    "href": "/docs/components/control/redirect-to-signin"
+                  },
+                  {
+                    "title": "`<RedirectToSignUp />`",
+                    "wrap": false,
+                    "href": "/docs/components/control/redirect-to-signup"
+                  },
+                  {
+                    "title": "`<RedirectToUserProfile />`",
+                    "wrap": false,
+                    "href": "/docs/components/control/redirect-to-userprofile"
+                  },
+                  {
+                    "title": "`<RedirectToOrganizationProfile />`",
+                    "wrap": false,
+                    "href": "/docs/components/control/redirect-to-organizationprofile"
+                  },
+                  {
+                    "title": "`<RedirectToCreateOrganization />`",
+                    "wrap": false,
+                    "href": "/docs/components/control/redirect-to-createorganization"
+                  },
+                  {
+                    "title": "`<SignedIn>`",
+                    "wrap": false,
+                    "href": "/docs/components/control/signed-in"
+                  },
+                  {
+                    "title": "`<SignedOut>`",
+                    "wrap": false,
+                    "href": "/docs/components/control/signed-out"
+                  }
+                ]
+              ]
+            }
+          ]
+        ]
+      },
+      {
+        "title": "Customization",
+        "items": [
+          [
+            {
+              "title": "Appearance Prop",
+              "href": "/docs/components/clerk-provider"
+            },
+            {
+              "title": "Localization (i18n)",
+              "href": "/docs/components/customization/localization"
+            },
+            {
+              "title": "Extending Clerk Components",
+              "collapse": true,
+              "items": [
+                [
+                  {
+                    "title": "Extending `<UserProfile />`",
+                    "href": "/docs/components/customization/user-profile"
+                  },
+                  {
+                    "title": "Extending `<OrganizationProfile />`",
+                    "href": "/docs/components/customization/organization-profile"
+                  }
+                ]
+              ]
+            }
+          ]
+        ]
+      }
+    ]
+  ]
+}

docs/manifest.custom-flows.json

@@ -0,0 +1,80 @@
+{
+  "$schema": "./manifest.schema.json",
+  "banner": {
+    "type": "caution",
+    "title": "Advanced",
+    "text": "Custom Flows are for advanced use cases that require extreme levels of control. Clerk provides better out-of-the-box functionality when using our prebuilt UI components.",
+    "cta": "View UI Components",
+    "href": "/docs/ui-components/overview"
+  },
+  "navigation": [
+    [
+      {
+        "title": "⚠ Rebuilding existing Clerk flows",
+        "href": "/docs/custom-flows/overview"
+      },
+      {
+        "title": "From scratch",
+        "items": [
+          [
+            {
+              "title": "`useSignUp()` and `useSignIn()`",
+              "href": "/docs/custom-flows/use-sign-up"
+            },
+            {
+              "title": "Email & Password",
+              "href": "/docs/custom-flows/email-password"
+            },
+            {
+              "title": "Email / SMS OTP",
+              "href": "/docs/custom-flows/email-sms-otp"
+            },
+            {
+              "title": "Email links",
+              "href": "/docs/custom-flows/email-links"
+            },
+            { "title": "Multifactor", "href": "/docs/custom-flows/mfa" },
+            { "title": "Passkeys", "href": "/docs/custom-flows/passkeys" },
+            {
+              "title": "OAuth Connections",
+              "href": "/docs/custom-flows/oauth-connections"
+            },
+            {
+              "title": "SAML Connections",
+              "href": "/docs/custom-flows/saml-connections"
+            },
+            {
+              "title": "Forgot Password",
+              "href": "/docs/custom-flows/forgot-password"
+            },
+            { "title": "Sign out", "href": "/docs/custom-flows/sign-out" },
+            {
+              "title": "Invitations",
+              "href": "/docs/custom-flows/invitations"
+            },
+            {
+              "title": "Embedded Email Links",
+              "href": "/docs/custom-flows/embedded-email-links"
+            },
+            {
+              "title": "Multi-session applications",
+              "href": "/docs/custom-flows/multi-session-applications"
+            },
+            {
+              "title": "Error handling",
+              "href": "/docs/custom-flows/error-handling"
+            },
+            {
+              "title": "User Impersonation",
+              "href": "/docs/custom-flows/user-impersonation"
+            },
+            {
+              "title": "Bot sign-up protection",
+              "href": "/docs/custom-flows/bot-sign-up-protection"
+            }
+          ]
+        ]
+      }
+    ]
+  ]
+}