SDK overview

The Base44 SDK provides a JavaScript interface for building apps on the Base44 platform. You can use it in two ways:

Inside Base44 apps: When Base44 generates your app, the SDK is already set up and ready to use.
External apps: Use the SDK to build your own frontend or backend that uses Base44 as a backend service.

Building a platform that runs the Base44 app editor inside your own product? Use the Platform SDK instead. The Platform SDK is a separate package, @base44/platform, and follows the AI chat of the apps your server opens a session for.

Modules

The SDK provides access to Base44’s functionality through the following modules:

actors: Build realtime, multi-client features with shared backend sessions, or run scheduled backend jobs.
agents: Interact with AI agents and manage conversations.
aiGateway: Call Base44’s managed AI models from your own code through an OpenAI-compatible client.
analytics: Track custom events and user actions in your app.
app: Read the app’s public settings, including its visibility.
appLogs: Access and query app logs.
auth: Manage user authentication, registration, and session handling.
browser: Create remote browser sessions to automate websites with Playwright or Puppeteer (service role only).
connectors: Manage OAuth connections and access tokens for third-party services.
entities: Work with your app’s data entities using CRUD operations.
functions: Execute backend functions.
integrations: Access third-party integrations.
payments: Accept one-time payments and subscriptions through your app’s connected payment provider, and manage purchases, refunds, and subscriptions.
sso: Retrieve SSO tokens to authenticate users with external systems (service role only).

Installation

Inside Base44 apps: The SDK is already available—no installation needed. External apps: Install the SDK via npm:

npm install @base44/sdk

Quick start

Inside Base44 apps

In Base44-generated apps, the client is pre-configured. Just import and use it:

import { base44 } from "@/api/base44Client";

// Create a new task
const newTask = await base44.entities.Task.create({
  title: "Complete project documentation",
  status: "pending",
  dueDate: "2024-12-31",
});

// Update the task
await base44.entities.Task.update(newTask.id, {
  status: "in-progress",
});

// List all tasks
const tasks = await base44.entities.Task.list();

External apps

When using Base44 as a backend for your own app, install the SDK and create the client yourself:

import { createClient } from "@base44/sdk";

// Create a client for your Base44 app
const base44 = createClient({
  appId: "your-app-id", // Find this in the Base44 editor URL
});

// Read public data
const products = await base44.entities.Products.list();

// Authenticate a user (token is automatically set)
await base44.auth.loginViaEmailPassword("[email protected]", "password");

// Access user's data
const userOrders = await base44.entities.Orders.list();

Get started

The best way to get started with the JavaScript SDK is to have Base44 build an app for you. Once you have an app, you can explore the generated code and experiment with the SDK to see how it works in practice. You can also ask Base44 to demonstrate specific features of the SDK. For a deeper understanding, check out these guides:

Base44 client - Work with the client in frontend, backend, and external app contexts.
Work with data - Create, read, update, and delete data.
Common SDK patterns - Authentication, integrations, functions, and error handling.
Actors - Build realtime features with actor sessions.

Base44 SDKs

App SDK

Platform SDK (Beta)

Modules

Installation

Quick start

Inside Base44 apps

External apps

Get started