Enterprise Application (EA)

The Enterprise Application (EA) is a Motanamy platform designed for large-scale business environments. It runs in the browser and provides a plugin system that lets developers extend the application with custom pages, dashboard widgets, settings screens, role-based permissions, and multi-language support.

What Plugins Can Do

An EA plugin can:

• Add dashboard widgets (task tiles on the home screen)
• Add settings pages with a sidebar entry under Settings
• Add main application pages accessible from the navigation
• Define role-based permissions controlled by administrators
• Register i18n translations in Arabic and English
• Add entries to the toolbar or dashboard navigation

How It Works

When EA loads, it reads your plugin's setting.json to find script.js. That script runs and calls registration methods on the plugins object to wire everything into the platform:

setting.json  →  loads script.js  →  registers widgets, pages, roles, translations

Quick Start

1. Download and access EA

Install via script:

wget -O - https://app.motanamy.com/MotanamyEA.sh | bash

Or download at motanamy.com/en/apps/EA.

2. Install the CLI and link your EA install

npm install -g motanamy-cli
mot link add

mot link add walks you through selecting EA and pointing the CLI at the app you just installed — required before mot run/mot build will work.

3. Create the plugin

mot create my-plugin --type EA
cd my-plugin

4. Edit script.js

plugins["my-plugin"] = function () {
    this.addLanguage("en", "myPlugin", { name: "My Plugin" });
    this.addLanguage("ar", "myPlugin", { name: "الإضافة الخاصة بي" });

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

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

5. Run and test

mot run

6. Build and upload

mot build
mot upload

Technology Stack

EA plugins use:

• Vue.js 3 — component framework
• PrimeVue — UI component library (Button, DataTable, Accordion, etc.)
• PrimeFlex — utility CSS classes
• MDI / PrimeIcons — icon sets

Next Steps

• File Structure & Development Guide
• script.js API Reference
• Full Music Plugin Example