feat(vue,nuxt): Add Vue and Nuxt SDK docs

docs/manifest.json

@@ -2427,6 +2427,74 @@
                 ]
               ]
             },
+            {
+              "title": "Vue",
+              "collapse": true,
+              "icon": "vue",
+              "items": [
+                [
+                  { "title": "Overview", "href": "/docs/references/vue/overview" },
+                  {
+                    "title": "Guides",
+                    "items": [
+                      [
+                        {
+                          "title": "Migrating from community SDK",
+                          "href": "/docs/references/vue/migrating-from-vue-community-sdk"
+                        }
+                      ]
+                    ]
+                  },
+                  {
+                    "title": "Client-side Helpers",
+                    "items": [
+                      [
+                        {
+                          "title": "`useUser()`",
+                          "wrap": false,
+                          "href": "/docs/references/vue/use-user"
+                        },
+                        {
+                          "title": "`useClerk()`",
+                          "wrap": false,
+                          "href": "/docs/references/vue/use-clerk"
+                        },
+                        {
+                          "title": "`useAuth()`",
+                          "wrap": false,
+                          "href": "/docs/references/vue/use-auth"
+                        },
+                        {
+                          "title": "`useSignIn()`",
+                          "wrap": false,
+                          "href": "/docs/references/vue/use-sign-in"
+                        },
+                        {
+                          "title": "`useSignUp`",
+                          "wrap": false,
+                          "href": "/docs/references/vue/use-sign-up"
+                        },
+                        {
+                          "title": "`useSession()`",
+                          "wrap": false,
+                          "href": "/docs/references/vue/use-session"
+                        },
+                        {
+                          "title": "`useSessionList()`",
+                          "wrap": false,
+                          "href": "/docs/references/vue/use-session-list"
+                        },
+                        {
+                          "title": "`useOrganization()`",
+                          "wrap": false,
+                          "href": "/docs/references/vue/use-organization"
+                        }
+                      ]
+                    ]
+                  }
+                ]
+              ]
+            },
             {
               "title": "Ruby / Rails",
               "collapse": true,

docs/references/vue/migrating-from-vue-community-sdk.mdx

@@ -0,0 +1,55 @@
+---
+title: 'Migrating from the Vue community SDK'
+description: Learn how to migrate from the Vue community SDK to the Clerk Vue SDK.
+---
+
+In December 2024, we introduced official support for Vue. This migration guide covers converting from the [`vue-clerk`](https://vue-clerk.vercel.app) community SDK to Clerk's official SDK. It covers the breaking changes that were introduced and provides examples on how to resolve them.
+
+## Installation
+
+Uninstall the community SDK and install Clerk's new official SDK for Vue.
+
+<CodeBlockTabs options={["npm", "yarn", "pnpm"]}>
+  ```bash {{ filename: 'terminal' }}
+  npm uninstall vue-clerk
+  npm install @clerk/vue
+  ```
+
+  ```bash {{ filename: 'terminal' }}
+  yarn remove vue-clerk
+  yarn add @clerk/vue
+  ```
+
+  ```bash {{ filename: 'terminal' }}
+  pnpm remove vue-clerk
+  pnpm add @clerk/vue
+  ```
+</CodeBlockTabs>
+
+## Breaking Changes
+
+### The `useClerk()` composable
+
+The composable now returns a Vue [Ref](https://vuejs.org/api/reactivity-core.html#ref) containing the Clerk instance, rather than returning the instance directly.
+
+Since it now returns a `Ref`, you can update your code as follows:
+
+```vue {{ del: [2, 9], ins: [3, [8, 9]] }}
+<script setup>
+import { useClerk } from 'vue-clerk'
+import { useClerk } from '@clerk/vue'
+
+const clerk = useClerk()
+
+function signIn() {
+  clerk.openSignIn()
+  clerk.value.openSignIn()
+}
+</script>
+
+<template>
+    <button @click="signIn">Sign in</button>
+</template>
+```
+
+Everything else should work as expected - just make sure to replace all `vue-clerk` imports with `@clerk/vue`.

docs/references/vue/overview.mdx

@@ -0,0 +1,19 @@
+---
+title: Clerk Vue SDK
+description: Learn how to use Clerk to quickly and easily add secure authentication and user management to your Vue application.
+---
+
+The Clerk Vue SDK is a wrapper around the Clerk JavaScript SDK. It is the recommended way to integrate Clerk into your Vue application.
+
+> [!IMPORTANT]
+> If you're using Nuxt, we recommend installing the `@clerk/nuxt` package since it's specifically built as a Nuxt module and includes backend integration. See the [Nuxt](/docs/references/nuxt/overview) documentation for more information.
+
+Clerk Vue provides Vue implementations of [Clerk components](/docs/components/overview); highly customizable, prebuilt components that you can use to build beautiful user management applications. You can find display components for building [sign-in](/docs/components/authentication/sign-in), [sign-up](/docs/components/authentication/sign-up), [account switching](/docs/components/user/user-button), and [user profile management](/docs/components/user/user-profile) pages as well as flow [control components](/docs/components/control/signed-in) that act as helpers for implementing a seamless authentication experience.
+
+Clerk Vue provides a suite of [custom composables](/docs/references/vue/use-user). These composables give you access to the [`Clerk` object](/docs/references/javascript/clerk/clerk), and a set of useful helper methods for signing in and signing up.
+
+## Setting up Clerk Vue
+
+You need to create a Clerk application in your Clerk Dashboard before you can set up Clerk Vue. For more information, check out [the dedicated guide.](/docs/quickstarts/setup-clerk)
+
+Once a Clerk application has been created, you can install and start using Clerk Vue in your application. [The quickstart guide](/docs/quickstarts/vue) will have all the information you need to get started.