@mindroid/sdk

The all-in-one SDK for building JS-first Android apps with Mindroid.
Install once and get the full runtime, all plugins, and developer utilities — no separate plugin installs needed.

Install

npm install @mindroid/sdk

Quick Start

import {
  createRuntime,
  createDeviceInfoPlugin,
  createNetworkPlugin,
  createCameraPlugin,
  MockBridge,
} from "@mindroid/sdk";

// MockBridge → replace with TransportBridge inside the Android host
const runtime = createRuntime(
  new MockBridge({
    "device.getInfo": { manufacturer: "Google", model: "Pixel 8", osVersion: "15", apiLevel: 35, abi: ["arm64-v8a"] },
    "permissions.ensure": "granted",
  }),
  createDeviceInfoPlugin(),
  createNetworkPlugin(),
  createCameraPlugin(),
);

console.log("Modules:", runtime.getModuleNames());
console.log("Capabilities:", runtime.getCapabilities());

What's included

| Package | Capabilities | |---------|-------------| | @mindroid/core | Runtime, bridge, permission gate, audit log, widget types, MockBridge, StubEngine | | @mindroid/plugin-device-info | Manufacturer, model, OS version, API level | | @mindroid/plugin-network | Network state, transport type (Wi-Fi / cellular), Wi-Fi info | | @mindroid/plugin-basic | Camera, location, sensors, notifications, contacts, Bluetooth, NFC, biometrics, background services, SMS, media, call log, calendar, dialer, clipboard, vibration, system |

Scaffold a new app

npx mindroid create my-app
cd my-app
mindroid build debug

The mindroid create command scaffolds an Android host project with @mindroid/sdk pre-installed and a ready-to-edit src/app.ts.

Architecture

Your app (TypeScript)
      ↓ imports
@mindroid/sdk  (this package)
      ↓ re-exports
@mindroid/core + plugins
      ↓ bridge.invoke()
Android host (Kotlin)
      ↓
Android OS APIs

Links

• Mindroid monorepo
• Android host template
• Full documentation