Platform SDK overview

The Platform SDK is in beta and is for white-label platforms that run Base44 inside their own product. Ask your onboarding contact to turn it on for your workspace.

The Platform SDK is the package a platform uses to put Base44’s app editor and its AI chat inside its own product. Your builders’ browsers use it to follow each build as it happens, and your server uses it to receive and verify Base44’s webhooks.

Building inside one Base44 app, with its entities, functions, and users? Use the App SDK instead. See Base44 SDKs to compare the two.

Entry points

The Platform SDK has two entry points:

@base44/platform: createPlatformClient() opens the browser connection, and its chat module follows the AI chat of up to eight apps over one connection.
@base44/platform/server: createPlatformServer() gives your backend the webhooks module, which verifies and handles the events Base44 sends.

Installation

Install the Platform SDK via npm:

npm install @base44/platform

Quick start

Your server opens a socket session with a workspace API key through Create socket session, and returns the response body to the browser. Keep the key on your server. The first step of Live updates shows how. In the browser, start a chat session, subscribe to an app, and connect:

import { createPlatformClient } from "@base44/platform";

const client = createPlatformClient();

const chat = client.chat.init({
  async getSession() {
    const response = await fetch("/api/chat-socket-session", { method: "POST" });
    return response.json();
  },
  onError: (error) => console.error("Live updates error", error.code),
});

chat.subscribe(appId, {
  onSnapshot(snapshot) {
    // Draw the app's chat: snapshot.messages and snapshot.status.
  },
  onEvent(event) {
    // Apply each change as it happens.
  },
  onError(error) {
    console.error(error.code);
  },
});

await chat.connect();

The connection is read-only, so prompts and answers go from your server to the Apps API.

Base44 SDKs

App SDK

Platform SDK (Beta)

Entry points

Installation

Quick start

See also

​Entry points

​Installation

​Quick start

​See also

Entry points

Installation

Quick start

See also