Quickstart

T1 is trusted local Node code and is not a sandbox. Run only a source you have reviewed and trust.

This page walks through a working T1 (local development) plugin from scratch: create the project → load it into evoX → assign it to a key → see it on the device. For tiers, you can first look at the Trust tiers page:

T0 · Data pack

Profile/icon/sound — no code, publishable today.

T1 · Local dev

This page. Separate Node process, not a sandbox.

T2 · Public sandbox

Default-deny capability; public upload closed.

1. Create the project

Node.js 20+ is enough; no installation needed:

npx @evoxapp/plugin-cli init my-plugin --runtime trusted-node --name "İlk Plugin"
cd my-plugin
npm install

The template produces:

my-plugin/
├── manifest.json    # Host sözleşmesi: kimlik, runtime, izinler, aksiyonlar
├── runtime.mjs      # Plugin giriş noktası (SDK client + event handler'lar)
├── package.json     # @evoxapp/plugin-sdk bağımlılığı
└── README.md        # Bu adımların özeti

runtime.mjs contains a ready example: the Hello action writes “Hello” when it appears on a key and shows the time when pressed. The template is produced in the CLI language (see Developer CLI); the values on this page are from the --lang en template.

client.on('action.keyDown', async (event) => {
  if (event.context?.actionId !== 'hello') return;
  await client.setTitle(event.context.bindingInstanceId, new Date().toLocaleTimeString('en-US', { hour: '2-digit', minute: '2-digit' }));
  await client.showSuccess(event.context.bindingInstanceId);
});

2. Load it into evoX

Open the Developer window

In the evoX desktop app, go to the Plugins section and click the Developer button in the top bar.

Select the project

Select the my-plugin folder with Select project. The manifest is validated by the host; if there is an error you see a clear message.

Grant trust and start

Read the T1 risk text and confirm trust, then start the plugin. The plugin runs as a separate Node process; you follow its status and logs from the same window.

Assign it to a key

On the Keys screen, assign the Hello action from the action library to a key. “Hello” appears on the key; pressing it writes the time.

3. Development loop

Change the code → reload from the Developer window. You don’t need to close the app.
Logs are shown bounded/redacted in the same window; your console.error output lands here.
Identity belongs to the host: client.session.plugin.pluginId is assigned, the plugin cannot choose its own identity/permissions.

Next steps

Write an integration plugin

OBS/Twitch/Spotify-style Market integrations (full Node + npm).

First real plugin (tutorial)

Build a weather indicator with settings + host-brokered network.

Event reference

The full event and host-RPC surface.

Manifest

Runtime, permission and action fields.

Public target (T2)

sandbox-js project: npx @evoxapp/plugin-cli init my-plugin (default) — the publication target once public upload opens.

Getting started

Core concepts

Examples and distribution

T0 · Data pack

T1 · Local dev

T2 · Public sandbox

1. Create the project

2. Load it into evoX

3. Development loop

Next steps

Write an integration plugin

First real plugin (tutorial)

Event reference

Manifest

Public target (T2)

T0 · Data pack

T1 · Local dev

T2 · Public sandbox

​1. Create the project

​2. Load it into evoX

​3. Development loop

​Next steps

Write an integration plugin

First real plugin (tutorial)

Event reference

Manifest

Public target (T2)

1. Create the project

2. Load it into evoX

3. Development loop

Next steps