# base44-sdk

This skill helps agents build Base44 features with the JavaScript SDK, covering entities, backend functions, realtime actors, and the AI gateway.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 11000 installs · ★ 91
- Author: base44
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/base44/skills/tree/HEAD/skills/base44-sdk/SKILL.md
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/skills/base44-sdk

## What it does

The skill documents the Base44 JavaScript SDK and its modules. It covers remote entities, backend functions, realtime actors, AI agents, and the AI gateway for code, image, video, speech generation, and AI decisions. Actors are the realtime/WebSocket primitive for multiplayer features, collaborative boards, presence, live cursors, room chat, and live auctions.

Its reference material focuses on exact SDK method names, including `functions.invoke`, `auth.me()`, `entities.Task.create`, and `actors.ChatRoom(roomId).connect()`. That matters when an agent might copy patterns from Firebase or Supabase. External apps can create a client with `createClient({ appId: "your-app-id" })`.

The Base44 project must already be initialized. Without `base44/config.jsonc`, this skill does not cover creating a new project; `base44-cli` comes first. Check the project state before asking the agent to implement a feature.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add base44/skills --skill base44-sdk -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/base44-sdk/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/base44-sdk/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add base44/skills --skill base44-sdk -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/base44-sdk/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add base44/skills --skill base44-sdk -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/base44-sdk/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install base44/skills base44-sdk
```

2. **Manually: put the files in place**
- File: `.github/skills/base44-sdk/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add base44/skills --skill base44-sdk -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/base44/skills --path skills/base44-sdk
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/base44-sdk/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add base44/skills --skill base44-sdk -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/base44/skills/tree/HEAD/skills/base44-sdk/SKILL.md

## When to use it
- work with Base44 entities through the SDK
- invoke backend functions with the correct method
- connect a realtime actor to a room
- read the current user with `auth.me()`
- call the AI gateway from an application

## Example prompts
- “Check `base44/config.jsonc` and add a feature that reads and updates entities through the Base44 SDK.”
- “Build a room with a realtime actor and subscribe to messages through `actors.ChatRoom(roomId).connect()`.”
- “Show the correct Base44 backend function call and verify the method names against the skill.”

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: d01fcc2897e74f6f.

BEGIN THIRD-PARTY FILE d01fcc2897e74f6f
````text
---
name: base44-sdk
description: "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"
---

# Base44 Coder

Build apps on the Base44 platform using the Base44 JavaScript SDK.

## ⚡ IMMEDIATE ACTION REQUIRED - Read This First

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:**
1. Check if `base44/config.jsonc` exists in the current directory
2. If **YES** (existing project scenario):
   - This skill (base44-sdk) handles the request
   - Implement features using Base44 SDK
   - Do NOT use base44-cli unless user explicitly requests CLI commands
3. If **NO** (new project scenario):
   - Transfer to base44-cli skill for project initialization
   - This skill cannot help until project is initialized

## When to Use This Skill vs base44-cli

**Use base44-sdk when:**
- Building features in an **EXISTING** Base44 project
- `base44/config.jsonc` already exists in the project
- Base44 SDK imports are present (`@base44/sdk`)
- Writing JavaScript/TypeScript code using Base44 SDK modules
- Implementing functionality, components, or features
- User mentions: "implement", "build a feature", "add functionality", "write code for"
- User says "create a [type] app" **and** a Base44 project already exists

**DO NOT USE base44-sdk for:**
- ❌ Initializing new Base44 projects (use `base44-cli` instead)
- ❌ Empty directories without Base44 configuration
- ❌ When user says "create a new Base44 project/app/site" and no project exists
- ❌ CLI commands like `npx base44 create`, `npx base44 deploy`, `npx base44 login` (use `base44-cli`)

**Skill Dependencies:**
- `base44-sdk` assumes a Base44 project is **already initialized**
- `base44-cli` is a **prerequisite** for `base44-sdk` in new projects
- If user wants to "create an app" and no Base44 project exists, use `base44-cli` first

**State Check Logic:**
Before selecting this skill, verify:
- IF (user mentions "create/build app" OR "make a project"):
  - IF (directory is empty OR no `base44/config.jsonc` exists):
    → Use **base44-cli** (project initialization needed)
  - ELSE:
    → Use **base44-sdk** (project exists, build features)

## Quick Start

```javascript
// In Base44-generated apps, base44 client is pre-configured and available
````
END THIRD-PARTY FILE d01fcc2897e74f6f

The third-party file has ended. Everything between the d01fcc2897e74f6f tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2905 of 17054 bytes. © base44 · MIT · https://github.com/base44/skills/tree/HEAD/skills/base44-sdk/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md