@moku-labs/system

Overview

@moku-labs/system gives Moku apps system capabilities behind one API: store, tray, notify, clipboard, deep-link, lifecycle, back, haptics and keepAwake. A Tauri provider runs when the native shell is detected, a web provider otherwise. Your code never branches on the runtime.

• One codebase, web and native. Each capability picks its provider once at startup.
• A degraded capability is data, never a throw. Every method returns SystemResult<T>: { ok: true, value } or { ok: false, reason }.
• Zero-leak bundles. Plugins live at subpath exports, and the @tauri-apps/* packages are optional peers loaded only in the native shell.

Install

bun add @moku-labs/system @moku-labs/core @moku-labs/common

Quick start

import { createApp } from "@moku-labs/system";
import { storePlugin } from "@moku-labs/system/store";

const system = createApp({
  plugins: [storePlugin],
  pluginConfigs: { store: { name: "my-app" } }
});

await system.start();

const result = await system.store.get<number>("count");
if (result.ok) {
  console.log(result.value ?? 0, `(from the ${result.provider} provider)`);
} else if (result.reason === "unsupported") {
  // hide the feature: this environment will never support it
} else {
  console.warn(result.reason, result.message);
}

await system.stop();

To build the native shell, compose the same capabilities in @moku-labs/native. It generates the Tauri permissions from that list.

Start with Claude

Describe what you want. The conductor picks the packages.