Standalone Application (SA)

SA is the Motanamy desktop client platform. Plugins run inside the SA renderer process and integrate directly into the sidebar navigation. Since SA runs locally on the user's machine, plugins interact with data through the api module — no backend server needed.

How Plugins Work

SA loads each installed plugin's script.js at startup. Your script registers routes, sidebar entries, widgets, and translations by calling methods on this:

plugins["my-plugin"] = function () {
    this.addLanguage("en", "my-plugin", { name: "My Plugin" });

    this.addTo({
        label: "My Plugin",
        key: "my-plugin.name",
        icon: "mdi mdi-puzzle-outline",
        to: "/app/my-plugin"
    }, "setting");

    this.addPage({
        name: "/[my-plugin]index.vue",
        path: "my-plugin",
        file: ["my-plugin", "index.vue"]
    }, "setting");
}

Tech Stack

Layer	Technology
UI Framework	Vue 3
Component Library	PrimeVue v3
CSS Utilities	PrimeFlex
Icons	PrimeIcons + MDI
Database	Local JSON via api module
Platform Events	EventBus from global

Key Difference from EA

SA has no backend. All data is read and written locally through api.database(). There is no main.js and no HTTP calls to a plugin server — everything runs in the renderer process.

Quick Start

1. Download the SA app — motanamy.com/en/apps/SA
2. Install the CLI — npm install -g motanamy-cli
3. Create the plugin folder structure (see Development Guide)
4. Write setting.json and script.js
5. Use mot run to link your plugin to a running SA instance

Resources

• Development Guide
• script.js API Reference
• Example Plugin