From 26c7d62698601bb5e4cbb4fdb2a95e4c31b471b7 Mon Sep 17 00:00:00 2001 From: Sam Markowitz Date: Thu, 5 Mar 2026 18:01:30 +0200 Subject: [PATCH 1/2] docs: expose serverUrl in CreateClientConfig for local development Remove @internal tag from serverUrl and add JSDoc with description, example, and default value so it appears in the SDK reference docs. Made-with: Cursor --- src/client.types.ts | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/src/client.types.ts b/src/client.types.ts index d5a83df..5ae3b4d 100644 --- a/src/client.types.ts +++ b/src/client.types.ts @@ -23,8 +23,21 @@ export interface CreateClientOptions { */ export interface CreateClientConfig { /** - * The Base44 server URL. Defaults to "https://base44.app". - * @internal + * The Base44 server URL. + * + * You don't need to set this for production use. The SDK defaults to `https://base44.app`. + * + * Set this when using the CLI's local development server ([`base44 dev`](https://docs.base44.com/developers/backend/overview/local-development)) to point SDK requests at your local machine instead of the hosted backend. + * + * @example + * ```typescript + * const base44 = createClient({ + * appId: "my-app-id", + * serverUrl: process.env.NEXT_PUBLIC_BASE44_URL, + * }); + * ``` + * + * @defaultValue `"https://base44.app"` */ serverUrl?: string; /** From 898b54611eda42e6a5194b7eadde741db365def9 Mon Sep 17 00:00:00 2001 From: Sam Markowitz Date: Sun, 8 Mar 2026 17:03:15 +0200 Subject: [PATCH 2/2] docs: simplify serverUrl JSDoc for framework-agnostic usage Remove the process.env example that doesn't work in Vite and simplify the description to be environment-agnostic. Made-with: Cursor --- src/client.types.ts | 10 +--------- 1 file changed, 1 insertion(+), 9 deletions(-) diff --git a/src/client.types.ts b/src/client.types.ts index 5ae3b4d..6a52d18 100644 --- a/src/client.types.ts +++ b/src/client.types.ts @@ -27,15 +27,7 @@ export interface CreateClientConfig { * * You don't need to set this for production use. The SDK defaults to `https://base44.app`. * - * Set this when using the CLI's local development server ([`base44 dev`](https://docs.base44.com/developers/backend/overview/local-development)) to point SDK requests at your local machine instead of the hosted backend. - * - * @example - * ```typescript - * const base44 = createClient({ - * appId: "my-app-id", - * serverUrl: process.env.NEXT_PUBLIC_BASE44_URL, - * }); - * ``` + * Set this when using a local development server to point SDK requests at your local machine instead of the hosted backend. * * @defaultValue `"https://base44.app"` */