SDK quickstart (JavaScript)

The ora.* SDK in five minutes: connect the client, set the app ID, make first calls.

4 min readUpdated: 20 August 2026

The JavaScript SDK is the fastest way into the platform. All modules follow the same pattern: create a client, set the app ID, make a call — every call is permission-checked.

Installation and connection

code

import { rumahlClient } from "rumahl-sdk";

const ora = rumahlClient({ baseUrl: "http://localhost:8126" });
ora.setAppId("my-app"); // required for app-scoped calls (secrets, storage)

First calls

code

// Send a notification
await ora.notifications.send({
  title: "Backup done",
  message: "All good — 12.4 GB verified",
});

// List files
const { files } = await ora.files.list({ folderId: null });

// Request a permission at runtime
await ora.permissions.request("AppStorageRead");

// Track a job
const job = await ora.jobs.create({ name: "Import", type: "import" });

The SDK surface

ora.notifications, ora.files, ora.storage, ora.clipboard
ora.permissions (request flow), ora.jobs, ora.secrets
ora.users, ora.devices, ora.home, ora.system.events

SDKs exist for JavaScript/TypeScript, Go, Python, PHP, C++ and Rust — the ora.* surface is the same everywhere.

On this page

Didn't solve your problem? Contact us — we're happy to help.