From b083b922c9ad42d0ee8b0ae2afeba2849f16226c Mon Sep 17 00:00:00 2001 From: Alexis Aguilar <98043211+alexisintech@users.noreply.github.com> Date: Thu, 8 May 2025 10:43:16 -0700 Subject: [PATCH 1/6] wip --- docs/references/javascript/clerk.mdx | 59 ++++++++++++++++------------ 1 file changed, 33 insertions(+), 26 deletions(-) diff --git a/docs/references/javascript/clerk.mdx b/docs/references/javascript/clerk.mdx index 7f87209cef..366ba43d2b 100644 --- a/docs/references/javascript/clerk.mdx +++ b/docs/references/javascript/clerk.mdx @@ -8,17 +8,24 @@ The `Clerk` class is the main entrypoint class for the `@clerk/clerk-js` package ## Properties - - `version` + - `client` + - [`Client`][client-ref] + + The `Client` object for the current window. + + --- + + - `domain` - `string` - A getter for the Clerk SDK version + A getter for the current Clerk app's domain. Prefixed with `clerk.` on production if not already prefixed. Returns `""` when ran on the server --- - - `loaded` - - `boolean` + - `instanceType` + - `'production' | 'development'` - A getter to see if the `Clerk` object is ready for use or not + A getter to see if a Clerk instance is running in production or development mode --- @@ -29,31 +36,31 @@ The `Clerk` class is the main entrypoint class for the `@clerk/clerk-js` package --- - - `domain` - - `string` + - `loaded` + - `boolean` - A getter for the current Clerk app's domain. Prefixed with `clerk.` on production if not already prefixed. Returns `""` when ran on the server + A getter to see if the `Clerk` object is ready for use or not --- - - `proxyUrl` - - `string` + - `organization` + - [Organization][organization-ref] | null | undefined - A getter for your Clerk app's proxy URL. Required for applications that run behind a reverse proxy. Can be either a relative path (`/__clerk`) or a full URL (`https:///__clerk`). + A shortcut to the last active `Session.user.organizationMemberships` which holds an instance of a `Organization` object. If the session is `null` or `undefined`, the user field will match. --- - - `instanceType` - - `'production' | 'development'` + - `proxyUrl` + - `string` - A getter to see if a Clerk instance is running in production or development mode + A getter for your Clerk app's proxy URL. Required for applications that run behind a reverse proxy. Can be either a relative path (`/__clerk`) or a full URL (`https:///__clerk`). --- - - `client` - - [`Client`][client-ref] + - `publishableKey` + - `string | undefined` - The `Client` object for the current window. + The Clerk Publishable Key for your instance. This can be found on the [**API keys**](https://dashboard.clerk.com/last-active?path=api-keys) page in the Clerk Dashboard. --- @@ -64,24 +71,24 @@ The `Clerk` class is the main entrypoint class for the `@clerk/clerk-js` package --- - - `user` - - [User][user-ref] | null | undefined + - `status` + - `'degraded' | 'error' | 'loading' | 'ready'` - A shortcut to `Session.user` which holds the currently active `User` object. If the session is `null` or `undefined`, the user field will match. + The status of the Clerk instance. --- - - `organization` - - [Organization][organization-ref] | null | undefined + - `user` + - [User][user-ref] | null | undefined - A shortcut to the last active `Session.user.organizationMemberships` which holds an instance of a `Organization` object. If the session is `null` or `undefined`, the user field will match. + A shortcut to `Session.user` which holds the currently active `User` object. If the session is `null` or `undefined`, the user field will match. --- - - `publishableKey` - - `string | undefined` + - `version` + - `string` - The Clerk Publishable Key for your instance. This can be found on the [**API keys**](https://dashboard.clerk.com/last-active?path=api-keys) page in the Clerk Dashboard. + A getter for the Clerk SDK version ## Methods From 08b2927d4d7471b6e62695b83d33066d891a4fed Mon Sep 17 00:00:00 2001 From: Alexis Aguilar <98043211+alexisintech@users.noreply.github.com> Date: Wed, 21 May 2025 16:35:55 +0700 Subject: [PATCH 2/6] wip --- .../control-components-with-expo.mdx | 213 ++++++++++++++++++ .../control-components-without-expo.mdx | 186 +++++++++++++++ docs/components/control/clerk-degraded.mdx | 12 + docs/components/control/clerk-failed.mdx | 12 + docs/components/control/clerk-loaded.mdx | 97 +------- docs/components/control/clerk-loading.mdx | 128 +---------- docs/manifest.json | 10 + docs/references/javascript/clerk.mdx | 115 +++++++++- 8 files changed, 544 insertions(+), 229 deletions(-) create mode 100644 docs/_partials/control-components-with-expo.mdx create mode 100644 docs/_partials/control-components-without-expo.mdx create mode 100644 docs/components/control/clerk-degraded.mdx create mode 100644 docs/components/control/clerk-failed.mdx diff --git a/docs/_partials/control-components-with-expo.mdx b/docs/_partials/control-components-with-expo.mdx new file mode 100644 index 0000000000..72f5d870e9 --- /dev/null +++ b/docs/_partials/control-components-with-expo.mdx @@ -0,0 +1,213 @@ + + + + ```tsx {{ filename: 'app/page.tsx' }} + import { ClerkLoaded, ClerkLoading, ClerkDegraded, ClerkFailed } from '@clerk/nextjs' + + declare global { + interface Window { + Clerk: any + } + } + + export default function Page() { + return ( + <> + +

Clerk is loading...

+ + +

Clerk has loaded (ready or degraded)

+ + +

Clerk is experiencing issues. Please try again later.

+ + + +

Something went wrong with Clerk. Please contact support.

+ + + ) + } + ``` + + ```tsx {{ filename: 'pages/index.tsx' }} + import { ClerkLoaded, ClerkLoading, ClerkDegraded, ClerkFailed } from '@clerk/nextjs' + + declare global { + interface Window { + Clerk: any + } + } + + export default function Page() { + return ( + <> + +

Clerk is loading...

+ + +

Clerk has loaded (ready or degraded)

+ + +

Clerk is experiencing issues. Please try again later.

+ + + +

Something went wrong with Clerk. Please contact support.

+ + + ) + } + ``` + + + + + ```tsx {{ filename: 'app/index.tsx' }} + import { ClerkLoading, ClerkLoaded } from '@clerk/clerk-expo' + import { Text, View } from 'react-native' + + declare global { + interface Window { + Clerk: any + } + } + + export default function Screen() { + return ( + + + Clerk is loading + + + Clerk has loaded (ready or degraded) + + + + ) + } + ``` + + + + ```tsx {{ filename: 'example.tsx' }} + import { ClerkLoaded, ClerkLoading, ClerkDegraded, ClerkFailed } from '@clerk/clerk-react' + + declare global { + interface Window { + Clerk: any + } + } + + export default function Example() { + return ( + <> + +

Clerk is loading...

+ + +

Clerk has loaded (ready or degraded)

+ + +

Clerk is experiencing issues. Please try again later.

+ + + +

Something went wrong with Clerk. Please contact support.

+ + + ) + } + ``` + + + + ```tsx {{ filename: 'app/routes/example.tsx' }} + import { ClerkLoading, ClerkLoaded, ClerkDegraded, ClerkFailed } from '@clerk/react-router' + + export default function Example() { + return ( + <> + +

Clerk is loading...

+ + +

Clerk has loaded (ready or degraded)

+ + +

Clerk is experiencing issues. Please try again later.

+ + + +

Something went wrong with Clerk. Please contact support.

+ + + ) + } + ``` + + + + ```tsx {{ filename: 'routes/index.tsx' }} + import { ClerkLoading, ClerkLoaded, ClerkDegraded, ClerkFailed } from '@clerk/remix' + + declare global { + interface Window { + Clerk: any + } + } + + export default function Index() { + return ( + <> + +

Clerk is loading...

+ + +

Clerk has loaded (ready or degraded)

+ + +

Clerk is experiencing issues. Please try again later.

+ + + +

Something went wrong with Clerk. Please contact support.

+ + + ) + } + ``` + + + + ```tsx {{ filename: 'app/routes/example.tsx' }} + import { ClerkLoading, ClerkLoaded, ClerkDegraded, ClerkFailed } from '@clerk/tanstack-react-start' + import { createFileRoute } from '@tanstack/react-router' + + export const Route = createFileRoute('/example')({ + component: Example, + }) + + function Example() { + return ( + <> + +

Clerk is loading...

+ + +

Clerk has loaded (ready or degraded)

+ + +

Clerk is experiencing issues. Please try again later.

+ + + +

Something went wrong with Clerk. Please contact support.

+ + + ) + } + ``` + + diff --git a/docs/_partials/control-components-without-expo.mdx b/docs/_partials/control-components-without-expo.mdx new file mode 100644 index 0000000000..b52605b839 --- /dev/null +++ b/docs/_partials/control-components-without-expo.mdx @@ -0,0 +1,186 @@ + + + + ```tsx {{ filename: 'app/page.tsx' }} + import { ClerkLoaded, ClerkLoading, ClerkDegraded, ClerkFailed } from '@clerk/nextjs' + + declare global { + interface Window { + Clerk: any + } + } + + export default function Page() { + return ( + <> + +

Clerk is loading...

+ + +

Clerk has loaded (ready or degraded)

+ + +

Clerk is experiencing issues. Please try again later.

+ + + +

Something went wrong with Clerk. Please contact support.

+ + + ) + } + ``` + + ```tsx {{ filename: 'pages/index.tsx' }} + import { ClerkLoaded, ClerkLoading, ClerkDegraded, ClerkFailed } from '@clerk/nextjs' + + declare global { + interface Window { + Clerk: any + } + } + + export default function Page() { + return ( + <> + +

Clerk is loading...

+ + +

Clerk has loaded (ready or degraded)

+ + +

Clerk is experiencing issues. Please try again later.

+ + + +

Something went wrong with Clerk. Please contact support.

+ + + ) + } + ``` + + + + + ```tsx {{ filename: 'example.tsx' }} + import { ClerkLoaded, ClerkLoading, ClerkDegraded, ClerkFailed } from '@clerk/clerk-react' + + declare global { + interface Window { + Clerk: any + } + } + + export default function Example() { + return ( + <> + +

Clerk is loading...

+ + +

Clerk has loaded (ready or degraded)

+ + +

Clerk is experiencing issues. Please try again later.

+ + + +

Something went wrong with Clerk. Please contact support.

+ + + ) + } + ``` + + + + ```tsx {{ filename: 'app/routes/example.tsx' }} + import { ClerkLoading, ClerkLoaded, ClerkDegraded, ClerkFailed } from '@clerk/react-router' + + export default function Example() { + return ( + <> + +

Clerk is loading...

+ + +

Clerk has loaded (ready or degraded)

+ + +

Clerk is experiencing issues. Please try again later.

+ + + +

Something went wrong with Clerk. Please contact support.

+ + + ) + } + ``` + + + + ```tsx {{ filename: 'routes/index.tsx' }} + import { ClerkLoading, ClerkLoaded, ClerkDegraded, ClerkFailed } from '@clerk/remix' + + declare global { + interface Window { + Clerk: any + } + } + + export default function Index() { + return ( + <> + +

Clerk is loading...

+ + +

Clerk has loaded (ready or degraded)

+ + +

Clerk is experiencing issues. Please try again later.

+ + + +

Something went wrong with Clerk. Please contact support.

+ + + ) + } + ``` + + + + ```tsx {{ filename: 'app/routes/example.tsx' }} + import { ClerkLoading, ClerkLoaded, ClerkDegraded, ClerkFailed } from '@clerk/tanstack-react-start' + import { createFileRoute } from '@tanstack/react-router' + + export const Route = createFileRoute('/example')({ + component: Example, + }) + + function Example() { + return ( + <> + +

Clerk is loading...

+ + +

Clerk has loaded (ready or degraded)

+ + +

Clerk is experiencing issues. Please try again later.

+ + + +

Something went wrong with Clerk. Please contact support.

+ + + ) + } + ``` + + diff --git a/docs/components/control/clerk-degraded.mdx b/docs/components/control/clerk-degraded.mdx new file mode 100644 index 0000000000..b608cef1e4 --- /dev/null +++ b/docs/components/control/clerk-degraded.mdx @@ -0,0 +1,12 @@ +--- +title: '``' +description: The `` component indicates that Clerk is partially operational. +--- + +The `` component indicates that Clerk is partially operational. + +## Usage + +It's not recommended to wrap the entire app in the `` component; instead, only wrap the components that need access to the `Clerk` object. + + diff --git a/docs/components/control/clerk-failed.mdx b/docs/components/control/clerk-failed.mdx new file mode 100644 index 0000000000..a018f2646a --- /dev/null +++ b/docs/components/control/clerk-failed.mdx @@ -0,0 +1,12 @@ +--- +title: '``' +description: The `` component indicates that the Clerk object has failed to load. +--- + +The `` component indicates that the Clerk object has failed to load. This is useful for displaying an error message to the user. + +## Usage + +It's not recommended to wrap the entire app in the `` component; instead, only wrap the components that need access to the `Clerk` object. + + diff --git a/docs/components/control/clerk-loaded.mdx b/docs/components/control/clerk-loaded.mdx index 583604a200..9432c247b8 100644 --- a/docs/components/control/clerk-loaded.mdx +++ b/docs/components/control/clerk-loaded.mdx @@ -3,103 +3,10 @@ title: '``' description: The `` component guarantees that the Clerk object has loaded and will be available under `window.Clerk`. This allows you to wrap child components to access the Clerk object without the need to check it exists. --- -The `` component guarantees that the Clerk object has loaded and will be available under `window.Clerk`. This allows you to wrap child components to access the `Clerk` object without the need to check it exists. +The `` component guarantees that the Clerk object has loaded (the `status` is `'ready'` or `'degraded'`) and will be available under `window.Clerk`. This allows you to wrap child components to access the `Clerk` object without the need to check it exists. ## Usage It's not recommended to wrap the entire app in the `` component; instead, only wrap the components that need access to the `Clerk` object. - - - - - ```tsx {{ filename: 'app/page.tsx' }} - import { ClerkLoaded } from '@clerk/nextjs' - - export default function Page() { - return ( - -

Clerk has loaded

- - - ) - } - ``` - - - - ```tsx {{ filename: 'pages/index.tsx' }} - import { ClerkLoaded } from '@clerk/nextjs' - - export default function Page() { - return ( - -

Clerk has loaded

- - - ) - } - ``` - - - - - - ```tsx {{ filename: 'example.tsx' }} - import { ClerkLoaded } from '@clerk/clerk-react' - - declare global { - interface Window { - Clerk: any - } - } - - export default function Example() { - return ( - -

Clerk has loaded

- - ) - } - ``` - - - - ```tsx {{ filename: 'routes/index.tsx' }} - import { ClerkLoaded } from '@clerk/remix' - - declare global { - interface Window { - Clerk: any - } - } - - export default function Index() { - return ( -
- -

Clerk has loaded

- -
- ) - } - ``` - - - - ```tsx {{ filename: 'app/index.tsx' }} - import { ClerkLoaded } from '@clerk/clerk-expo' - import { Text, View } from 'react-native' - - export default function Screen() { - return ( - - - Clerk has loaded - - - ) - } - ``` - - + diff --git a/docs/components/control/clerk-loading.mdx b/docs/components/control/clerk-loading.mdx index 06918ed818..2467c10bf5 100644 --- a/docs/components/control/clerk-loading.mdx +++ b/docs/components/control/clerk-loading.mdx @@ -9,130 +9,4 @@ The `` renders its children while Clerk is loading, and is helpful It's not recommended to wrap the entire app in the `` component; instead, only wrap the components that need access to the `Clerk` object. - - - - ```tsx {{ filename: 'app/page.tsx' }} - import { ClerkLoaded, ClerkLoading } from '@clerk/nextjs' - - declare global { - interface Window { - Clerk: any - } - } - - export default function Page() { - return ( - <> - -

Clerk is loading...

- - -

Clerk has loaded

- - - ) - } - ``` - - ```tsx {{ filename: 'pages/index.tsx' }} - import { ClerkLoaded, ClerkLoading } from '@clerk/nextjs' - - declare global { - interface Window { - Clerk: any - } - } - - export default function Page() { - return ( - <> - -

Clerk is loading

- - -

Clerk has loaded

- - - ) - } - ``` - - - - - ```tsx {{ filename: 'example.tsx' }} - import { ClerkLoaded, ClerkLoading } from '@clerk/clerk-react' - - declare global { - interface Window { - Clerk: any - } - } - - export default function Example() { - return ( - <> - -

Clerk is loading

- - -

Clerk has loaded

- - - ) - } - ``` - - - - ```tsx {{ filename: 'routes/index.tsx' }} - import { ClerkLoading, ClerkLoaded } from '@clerk/remix' - - declare global { - interface Window { - Clerk: any - } - } - - export default function Index() { - return ( - <> - -

Clerk is loading

- - -

Clerk has loaded

- - - ) - } - ``` - - - - ```tsx {{ filename: 'app/index.tsx' }} - import { ClerkLoading, ClerkLoaded } from '@clerk/clerk-expo' - import { Text, View } from 'react-native' - - declare global { - interface Window { - Clerk: any - } - } - - export default function Screen() { - return ( - - - Clerk is loading - - - Clerk has loaded - - - ) - } - ``` - - + diff --git a/docs/manifest.json b/docs/manifest.json index f041af969e..8dfb2e3fde 100644 --- a/docs/manifest.json +++ b/docs/manifest.json @@ -2049,6 +2049,16 @@ "wrap": false, "href": "/docs/components/control/authenticate-with-callback" }, + { + "title": "``", + "wrap": false, + "href": "/docs/components/control/clerk-degraded" + }, + { + "title": "``", + "wrap": false, + "href": "/docs/components/control/clerk-failed" + }, { "title": "``", "wrap": false, diff --git a/docs/references/javascript/clerk.mdx b/docs/references/javascript/clerk.mdx index 366ba43d2b..972c036ff6 100644 --- a/docs/references/javascript/clerk.mdx +++ b/docs/references/javascript/clerk.mdx @@ -18,28 +18,35 @@ The `Clerk` class is the main entrypoint class for the `@clerk/clerk-js` package - `domain` - `string` - A getter for the current Clerk app's domain. Prefixed with `clerk.` on production if not already prefixed. Returns `""` when ran on the server + The current Clerk app's domain. Prefixed with `clerk.` on production if not already prefixed. Returns `""` when ran on the server --- - `instanceType` - `'production' | 'development'` - A getter to see if a Clerk instance is running in production or development mode + Indicates if the Clerk instance is running in production or development mode. --- - `isSatellite` - `boolean` - Clerk Flag for satellite apps + A boolean that indicates if the instance is a satellite app. + + --- + + - `isSignedIn` + - `boolean` + + A boolean that indicates if the user is signed in. --- - `loaded` - `boolean` - A getter to see if the `Clerk` object is ready for use or not + A boolean that indicates if the `Clerk` object is ready for use. Set to `false` when the `status` is `'loading'` or `'error'`. Set to `true` when the `status` is either `'ready'` or `'degraded'`. --- @@ -53,7 +60,7 @@ The `Clerk` class is the main entrypoint class for the `@clerk/clerk-js` package - `proxyUrl` - `string` - A getter for your Clerk app's proxy URL. Required for applications that run behind a reverse proxy. Can be either a relative path (`/__clerk`) or a full URL (`https:///__clerk`). + Your Clerk app's proxy URL. Required for applications that run behind a reverse proxy. Can be either a relative path (`/__clerk`) or a full URL (`https:///__clerk`). --- @@ -64,6 +71,13 @@ The `Clerk` class is the main entrypoint class for the `@clerk/clerk-js` package --- + - `sdkMetadata` + - `{ name: string; version: string; environment: string }` + + Contains information about the SDK that the host application is using. You don't need to set this value yourself unless you're [developing an SDK](/docs/references/sdk/overview). + + --- + - `session` - [Session][session-ref] | null | undefined @@ -74,7 +88,19 @@ The `Clerk` class is the main entrypoint class for the `@clerk/clerk-js` package - `status` - `'degraded' | 'error' | 'loading' | 'ready'` - The status of the Clerk instance. + The status of the Clerk instance. Possible values are: + + - `'degraded'`: Set when Clerk is partially operational. + - `'error'`: Set when hotloading `clerk-js` failed or `Clerk.load()` failed. + - `'loading'`: Set during initialization. + - `'ready'`: Set when Clerk is fully operational. + + --- + + - `telemetry?` + - `{ disabled: boolean, debug: boolean }` + + [Telemetry](/docs/telemetry) configuration. --- @@ -88,7 +114,7 @@ The `Clerk` class is the main entrypoint class for the `@clerk/clerk-js` package - `version` - `string` - A getter for the Clerk SDK version + The Clerk SDK version. ## Methods @@ -970,6 +996,81 @@ await clerk.navigate('/dashboard') The route to navigate to. +### `on()` + +Registers an event handler for a specific Clerk event. + +```ts +type OnEventListener = ( + event: E, + handler: EventHandler, + opt?: { + notify: boolean + }, +) => void +``` + +#### Example + +```js +window.Clerk.on('status', (status) => {}) +window.Clerk.on('status', (status) => {}, { notify: true }) +``` + +#### Parameters + + + - `event` + - `E` + + The event to listen to. Currently, the only supported event is `status`. + + --- + + - `handler` + - `EventHandler` + + The handler to call when the event is triggered. + + --- + + - `opt?` + - `{ notify: boolean }` + + An optional object to control the behavior of the event handler. If true, and the event was previously dispatched, handler will be called immediately with the latest payload + + +### `off()` + +Removes an event handler for a specific Clerk event. + +```ts +type OffEventListener = (event: E, handler: EventHandler) => void +``` + +#### Example + +```js +window.Clerk.off('status') +window.Clerk.off('status', (status) => {}) +``` + +#### Parameters + + + - `event` + - `E` + + The event to remove the handler from. Currently, the only supported event is `status`. + + --- + + - `handler` + - `EventHandler` + + The handler to remove. + + ### `redirectToCreateOrganization()` Redirects to the configured URL where [``](/docs/components/organization/create-organization) is mounted. This method uses the [`navigate()`](#navigate) method under the hood. From 87caf831ac7535cef80fc8afe3be9958b0d7acd8 Mon Sep 17 00:00:00 2001 From: Alexis Aguilar <98043211+alexisintech@users.noreply.github.com> Date: Fri, 6 Jun 2025 09:56:53 +0700 Subject: [PATCH 3/6] Update docs/references/javascript/clerk.mdx Co-authored-by: Sarah Soutoul --- docs/references/javascript/clerk.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/references/javascript/clerk.mdx b/docs/references/javascript/clerk.mdx index 972c036ff6..29cf60bd8b 100644 --- a/docs/references/javascript/clerk.mdx +++ b/docs/references/javascript/clerk.mdx @@ -18,7 +18,7 @@ The `Clerk` class is the main entrypoint class for the `@clerk/clerk-js` package - `domain` - `string` - The current Clerk app's domain. Prefixed with `clerk.` on production if not already prefixed. Returns `""` when ran on the server + The current Clerk app's domain. Prefixed with `clerk.` on production if not already prefixed. Returns `""` when ran on the server. --- From d33b20dba66556e342cab7b780879a6e2fa83657 Mon Sep 17 00:00:00 2001 From: Alexis Aguilar <98043211+alexisintech@users.noreply.github.com> Date: Wed, 8 Oct 2025 19:43:26 -0400 Subject: [PATCH 4/6] fix --- docs/reference/javascript/clerk.mdx | 4 ---- 1 file changed, 4 deletions(-) diff --git a/docs/reference/javascript/clerk.mdx b/docs/reference/javascript/clerk.mdx index bda3a0f45e..d48f832e1d 100644 --- a/docs/reference/javascript/clerk.mdx +++ b/docs/reference/javascript/clerk.mdx @@ -19,11 +19,7 @@ The `Clerk` class is the main entrypoint class for the `@clerk/clerk-js` package - `domain` - `string` -<<<<<<< HEAD:docs/references/javascript/clerk.mdx The current Clerk app's domain. Prefixed with `clerk.` on production if not already prefixed. Returns `""` when ran on the server. -======= - The current `Session`, which is guaranteed to be one of the sessions in `Client.sessions`. If there is no current session, this field will be `null`. If the session is loading, this field will be `undefined`. ->>>>>>> main:docs/reference/javascript/clerk.mdx --- From e13aa3da9505a57fa79a6f7955dab21c85a2c5cf Mon Sep 17 00:00:00 2001 From: Alexis Aguilar <98043211+alexisintech@users.noreply.github.com> Date: Wed, 8 Oct 2025 19:45:25 -0400 Subject: [PATCH 5/6] fix incorrect links --- docs/reference/javascript/clerk.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/reference/javascript/clerk.mdx b/docs/reference/javascript/clerk.mdx index d48f832e1d..f3329a2091 100644 --- a/docs/reference/javascript/clerk.mdx +++ b/docs/reference/javascript/clerk.mdx @@ -75,7 +75,7 @@ The `Clerk` class is the main entrypoint class for the `@clerk/clerk-js` package - `sdkMetadata` - `{ name: string; version: string; environment: string }` - Contains information about the SDK that the host application is using. You don't need to set this value yourself unless you're [developing an SDK](/docs/references/sdk/overview). + Contains information about the SDK that the host application is using. You don't need to set this value yourself unless you're [developing an SDK](/docs/guides/development/sdk-development/overview). --- @@ -101,7 +101,7 @@ The `Clerk` class is the main entrypoint class for the `@clerk/clerk-js` package - `telemetry?` - `{ disabled: boolean, debug: boolean }` - [Telemetry](/docs/telemetry) configuration. + [Telemetry](/docs/guides/how-clerk-works/security/clerk-telemetry) configuration. --- From 390063379f7e7bed96d0f05b6352d481e34ae6c2 Mon Sep 17 00:00:00 2001 From: Alexis Aguilar <98043211+alexisintech@users.noreply.github.com> Date: Wed, 8 Oct 2025 19:50:10 -0400 Subject: [PATCH 6/6] update copy --- docs/reference/components/control/clerk-degraded.mdx | 2 +- docs/reference/components/control/clerk-failed.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/reference/components/control/clerk-degraded.mdx b/docs/reference/components/control/clerk-degraded.mdx index daf193696f..21a395b883 100644 --- a/docs/reference/components/control/clerk-degraded.mdx +++ b/docs/reference/components/control/clerk-degraded.mdx @@ -8,6 +8,6 @@ The `` component indicates that Clerk is partially operational. ## Example -It's not recommended to wrap the entire app in the `` component; instead, only wrap the components that need access to the `Clerk` object. +It's not recommended to wrap the entire app in control components; instead, only wrap the components that need access to the `Clerk` object, such as custom flows. diff --git a/docs/reference/components/control/clerk-failed.mdx b/docs/reference/components/control/clerk-failed.mdx index 53c6b05f5c..907a86cdd4 100644 --- a/docs/reference/components/control/clerk-failed.mdx +++ b/docs/reference/components/control/clerk-failed.mdx @@ -8,6 +8,6 @@ The `` component indicates that the Clerk object has failed to load ## Example -It's not recommended to wrap the entire app in the `` component; instead, only wrap the components that need access to the `Clerk` object. +It's not recommended to wrap the entire app in control components; instead, only wrap the components that need access to the `Clerk` object, such as custom flows.