- name
The base44 SDK is the library to communicate with base44 services. In projects, you use it to communicate with remote resources (entities, backend functions, realtime actors, ai agents, and the AI gat
SKILL.md
The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add base44/skills --skill base44-sdk -a cursor -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add base44/skills --skill base44-sdk -a claude-code -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add base44/skills --skill base44-sdk -a codex -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add base44/skills --skill base44-sdk -a grok -ySend the copied message in a Grok Bot chat. The Bot fetches this SKILL.md from GitHub and adds it to the skills all your Bots share.
Install this skill: https://github.com/base44/skills/tree/HEAD/skills/base44-sdkFrom the publisher
Build apps on the Base44 platform using the Base44 JavaScript SDK.
This skill activates on ANY mention of "base44" or when a base44/ folder exists. DO NOT read documentation files or search the web before acting.
Your first action MUST be:
base44/config.jsonc exists in the current directoryUse base44-sdk when:
base44/config.jsonc already exists in the project@base44/sdk)DO NOT USE base44-sdk for:
base44-cli instead)npx base44 create, npx base44 deploy, npx base44 login (use base44-cli)Skill Dependencies:
base44-sdk assumes a Base44 project is already initializedbase44-cli is a prerequisite for base44-sdk in new projectsbase44-cli firstState Check Logic: Before selecting this skill, verify:
base44/config.jsonc exists):
→ Use base44-cli (project initialization needed)// In Base44-generated apps, base44 client is pre-configured and available
// CRUD operations
const task = await base44.entities.Task.create({ title: "New task", status: "pending" });
const tasks = await base44.entities.Task.list();
await base44.entities.Task.update(task.id, { status: "done" });
// Get current user
const user = await base44.auth.me();
// External apps
import { createClient } from "@base44/sdk";
// IMPORTANT: Use 'appId' (NOT 'clientId' or 'id')
const base44 = createClient({ appId: "your-app-id" });
await base44.auth.loginViaEmailPassword("[email protected]", "password");
Before writing ANY Base44 code, verify method names against this table or QUICK_REFERENCE.md.
Base44 SDK has unique method names. Do NOT assume patterns from Firebase, Supabase, or other SDKs.
Exception: an OpenAI-compatible client (e.g. the Vercel AI SDK or the
openaiSDK) is correct when pointed atbase44.asServiceRole.aiGateway.connection()— that's how you build code agents (agent loops with tools) and call the gateway's image, video, and speech endpoints. UseInvokeLLMonly for a single call with no tools. See ai-gateway.md.
The two
subscribe()methods return different shapes.Connection.subscribe()(actors) returns an object —sub.unsubscribe().entities.<Name>.subscribe()returns the unsubscribe function itself —unsub(). Don't carry one convention to the other.
For client setup and authentication modes, see client.md.
Each reference file includes a "Type Definitions" section with TypeScript interfaces and types for the module's methods, parameters, and return values.
Getting typed entities, functions, actors, and agents: The Base44 CLI generates types from your project resources (entities, functions, actors, agents), including augmentations to EntityTypeRegistry, FunctionNameRegistry, ActorNameRegistry, and AgentNameRegistry, and wires them into your project so you get autocomplete and type checking without manual setup. For how to generate types, use the base44-cli skill.
Manual augmentation: You can instead augment the registries yourself in a .d.ts file; see the Type Definitions sections in entities.md, functions.md, actors.md, and base44-agents.md. Actor message types are always hand-authored — augment ActorRegistry so the actor and its clients share one definition.
Install the Base44 SDK:
npm install @base44/sdk
Important: Never assume or hardcode the @base44/sdk package version. Always install without a version specifier to get the latest version.
When creating a client in external apps, ALWAYS use appId as the parameter name:
import { createClient } from "@base44/sdk";
// ✅ CORRECT
const base44 = createClient({ appId: "your-app-id" });
// ❌ WRONG - Do NOT use these:
// const base44 = createClient({ clientId: "your-app-id" }); // WRONG
// const base44 = createClient({ id: "your-app-id" }); // WRONG
Required parameter: appId (string) - Your Base44 application ID
Optional parameters:
token (string) - Pre-authenticated user tokenoptions (object) - Configuration options
options.onError (function) - Global error handlerExample with error handler:
const base44 = createClient({
appId: "your-app-id",
options: {
onError: (error) => {
console.error("Base44 error:", error);
}
}
});
Working with app data?
entitiesentities.importEntities()entities.EntityName.subscribe()User management?
authauth.me()auth.updateMe()users.inviteUser()AI features?
agents (requires logged-in user)agents.createConversation()agents.getConversations()integrations.Core.InvokeLLM()integrations.Core.GenerateImage()aiGateway images (see ai-gateway.md)integrations.Core.GenerateVideo(); model choice, references, or frames → aiGateway videos, an async job (see ai-gateway.md)aiGateway with provider: "typesafe" (Jev), not InvokeLLM with a JSON schema (see ai-gateway.md)aiGateway (see ai-gateway.md)Custom backend logic?
functions.invoke()base44.asServiceRole.functions.invoke()Realtime shared session?
actors.<Name>(roomId).connect() (see actors.md)entities.EntityName.subscribe(), not an actorExternal services?
integrations.Core.SendEmail()integrations.Core.UploadFile()integrations.custom.call()asServiceRole.connectors.getConnection() (backend only)connectors.connectAppUser() (frontend) + asServiceRole.connectors.getCurrentAppUserConnection() (backend)asServiceRole.connectors.callApi() (backend only)asServiceRole.browser.getSession() (backend only)Payments?
asServiceRole.payments.createCheckout() (backend, creates it) + payments.mountCheckout() (frontend, renders it) — see payments.mdpayments.listPurchases()asServiceRole.payments.refund() / cancelSubscription() / pauseSubscription() / resumeSubscription() (backend only)Live voice?
asServiceRole.voice.createSession() (backend only, beta) — see voice.mdTracking and analytics?
analytics.track()appLogs.logUserInApp()app.getPublicSettings()const pendingTasks = await base44.entities.Task.filter(
{ status: "pending", assignedTo: userId }, // query
"-created_date", // sort (descending)
10, // limit
0 // skip
);
const user = await base44.auth.me();
if (!user) {
// Navigate to your custom login page
navigate('/login', { state: { returnTo: window.location.pathname } });
return;
}
// Frontend
// ⚠️ invoke() returns the RAW axios response — your function's JSON is on `.data`,
// NOT the top-level object. It also THROWS on non-2xx (error body at err.response.data).
const res = await base44.functions.invoke("processOrder", {
orderId: "123",
action: "ship"
});
const result = res.data; // ✅ e.g. res.data.success (res itself is { data, status, headers, … })
// Backend function
import { createClientFromRequest } from "npm:@base44/sdk";
export default async function (req) {
const base44 = createClientFromRequest(req);
const { orderId, action } = await req.json();
// Process with service role for admin access
const order = await base44.asServiceRole.entities.Orders.get(orderId);
return Response.json({ success: true });
}
// Frontend — connect inside useEffect and always clean up
useEffect(() => {
const room = base44.actors.ChatRoom(roomId).connect();
const sub = room.subscribe((msg) => {
if (msg.type === "message") setMessages((prev) => [...prev, msg]); // switch on type; drop unknowns
});
return () => { sub.unsubscribe(); room.close(); }; // NOTE: actors return { unsubscribe() },
}, [roomId]); // entities.subscribe() returns the function itself
// Actor — base44/actors/ChatRoom/entry.ts
import { Actor } from "base44:runtime/actors";
export default class ChatRoom extends Actor {
handleConnect(conn) { conn.send({ type: "welcome" }); } // one client
handleMessage(conn, msg) {
// Always validate: the payload is attacker-controlled and msg can even be null.
if (msg?.type !== "message" || typeof msg.text !== "string") return;
this.broadcast({ type: "message", text: msg.text.slice(0, 2000) }); // everyone
}
handleClose(conn) {}
}
Use asServiceRole in backend functions for admin-level operations. Actors expose this.client.asServiceRole for validated, room-owned work such as persisting canonical results; use verified conn.identity.userId from an authenticated connection for explicit user attribution. See actors.md.
// User mode - respects permissions
const myTasks = await base44.entities.Task.list();
// Service role - full access (backend only)
const allTasks = await base44.asServiceRole.entities.Task.list();
const token = await base44.asServiceRole.connectors.getAccessToken("slack");
Backend functions export default an async request handler and use createClientFromRequest(req) to get a properly authenticated client.
© 2026 Skills Rack.
---name: base44-sdkdescription: The base44 SDK is the library to communicate with base44 services. In projects, you use it to communicate with…---# skills/base44-sdk/SKILL.mdOverview
The base44 SDK is the library to communicate with base44 services. In projects, you use it to communicate with remote resources (entities, backend functions, realtime actors, ai agents, and the AI gateway for code agents, image, video, and speech generation, and AI decisions) and to write backend functions and actors. This skill is the place for learning about available modules and types, including actors — the realtime/WebSocket primitive for multiplayer, collaborative boards, presence and live cursors, in-room chat, and live auctions. When you plan or implement a feature, you must learn this skill
FAQ
Download skills/base44-sdk/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
The publisher keeps it at https://github.com/base44/skills.
Claude, Cursor, Codex, and Grok Build can read a SKILL.md you add from the publisher's repository. Grok Bot installs it when you send the skill's GitHub folder link in a chat.
app | Read the app's own public settings (visibility) | app.md |
users | Invite users to the app | users.md |
connectors | App user OAuth flows (start/disconnect the current user's own connection) | connectors.md |
asServiceRole.connectors | Shared/app-scoped OAuth tokens and metered connector calls (service role only) | connectors.md |
asServiceRole.sso | SSO token generation (service role only) | sso.md |
asServiceRole.browser | Remote browser automation sessions (service role only) | browser.md |
asServiceRole.voice | Live voice sessions, beta (service role only) | voice.md |
| No |
| Yes |