About base44-platform-actors
A Base44 development skill for configuring realtime actors in web and native mobile apps. It guides the agent to identify the app profile and consult the matching reference; actor deployment requires the Builder plan or above.
Key features
- 01Identifies app framework and runtime
- 02Selects web or mobile actor reference
- 03Uses the agent-profile endpoint
- 04Notes actor deployment entitlement
Use cases
- 01Choosing actor guidance for a Vite SPA
- 02Selecting references for TanStack Start
- 03Configuring actors in an Expo app
MCP support
Uses Base44 MCP's execute_api tool to retrieve an app profile; the profile determines which actor reference to consult.
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ base44/ skills --skill base44-platform-actorsAfter installing, type/base44-platform-actorsin Claude Code to confirm it loaded.
Bundled filesreferences/mobile.mdreferences/web.md
Details
From the project READMEBase44 actors
One actor instance per room id; the actor is authoritative, clients send operations. Writing the entry file deploys the actor.
Requires the Builder plan or above. The workspace's entitlement is reported by the agent-profile endpoint; on a lower plan the platform rejects the deploy.
Pick the reference for this app
Determine the app profile first. Call GET /api/apps/{app_id}/agent-profile (over the Base44 MCP execute_api
tool, or with your Base44 CLI token); it returns the framework, app type, runtime,
entitlements and the exact reference files to read. Without it, detect from the project files:
src/routes/__root.* and src/routeTree.gen.ts mean TanStack Start; app/_layout.* means a
native mobile (Expo) app; otherwise it is a Vite SPA.
| Profile | Read |
|---|---|
| Web app, Vite SPA (the default web template) | Realtime actors (web apps) |
| Web app, TanStack Start | Realtime actors (web apps) |
| Native mobile app (Expo, React Native) | Realtime actors (mobile apps) |