# Overview (/vela-pro/indicators/overview)



Vela Pro charts run Pine Script® scripts, native indicators written in TypeScript, and scripts executed by a custom scripting engine. All three indicator types share the same legend, settings dialog, and pane layout.

```ts
import { VelaWorkspace } from '@luxalgo/vela/workspace';
import { BinanceProvider } from '@luxalgo/vela/providers/binance';
import { enableVelaPro } from '@luxalgo/vela-pro';

enableVelaPro();

const workspace = new VelaWorkspace('#chart', {
    layout: false,
    symbol: 'BTCUSDT',
    timeframe: '60',
    live: true,
    providers: { binance: () => new BinanceProvider() },
});
const chart = workspace.chart;

// A native indicator computed directly by the chart.
chart.addNativeIndicator('rsi', { inputs: { length: 21 } });

// A Pine Script® source executed by the default Pine engine.
const ema = chart.addIndicator(`//@version=6
indicator("EMA 50", overlay=true)
plot(ta.ema(close, 50), color=color.orange)`);
ema.on('error', ({ error }) => console.warn(error.message));
```

Both methods return an `IndicatorHandle` immediately. Rendered values appear once the first computation finishes, at which point the handle emits its `ready` event.

## Indicator types [#indicator-types]

| Type                   | What you author                                                     | Execution runtime                                                                                                         | How it is added                                                                                   |
| ---------------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| Pine Script® script    | A Pine Script® v5 or v6 source string                               | The Pine engine (`@luxalgo/vela-pinets`, built on PineTS), registered as each chart's default engine by `enableVelaPro()` | `chart.addIndicator(source)`, the indicator menu, the code editor, or an indicator manifest entry |
| Native indicator       | A TypeScript descriptor registered with `registerNativeIndicator`   | The chart directly, with no scripting engine                                                                              | `chart.addNativeIndicator(type)`, or the Basic and Order flow tabs in the indicator menu          |
| Custom language script | Source code in your language and a `ScriptingEngine` implementation | Your custom engine, registered under a language key                                                                       | `chart.addIndicator(source, { language })`, a manifest entry, or a custom menu section            |

Pine Script® suits user-authored indicators and strategies; see [Pine Script® with PineTS](/vela-pro/indicators/pine/runtime) for engine configuration. Native indicators run inside your application bundle. Both the built-in studies from Vela's open-source core and Vela Pro's order-flow indicators use this mechanism; see [Built-in indicators](/vela-pro/indicators/included) for the full catalog. If your platform has an existing scripting language or remote calculation service, you can integrate it alongside Pine Script® as described in [Custom runtimes](/vela-pro/indicators/runtimes/engines).

Regardless of how an indicator is computed, its output is expressed in the same visual model of series, fills, lines, labels, boxes, and tables. See [Charting adapters](/vela-pro/indicators/runtimes/charting-adapters) for details on the output model.

## Adding indicators [#adding-indicators]

| Entry point                                | What it adds                                                                                  | Documentation                                                                  |
| ------------------------------------------ | --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| `chart.addIndicator(source, options?)`     | A script running on the chart's default engine or on the engine matching `language`           | [Pine Script® with PineTS](/vela-pro/indicators/pine/runtime)                  |
| `chart.addNativeIndicator(type, options?)` | A registered native indicator type                                                            | [Custom indicators](/vela-pro/indicators/custom-indicators)                    |
| Indicator menu                             | Built-in studies, order-flow indicators, LuxAlgo library scripts, and custom catalog sections | [Indicator menu](/vela-pro/indicators/library)                                 |
| Code editor Run button                     | The Pine Script® source open in the editor                                                    | [Pine code editor](/vela-pro/indicators/pine/code-editor)                      |
| `indicators` workspace option (manifest)   | Default scripts attached to every new chart                                                   | [Custom indicators](/vela-pro/indicators/custom-indicators#indicator-manifest) |

<Warning>
  A workspace configured with `persist: true` automatically restores saved native indicators on reload. If your initialization code also calls `addNativeIndicator` on every page load, another duplicate instance is added on each reload for any type that allows multiple instances. Call `addNativeIndicator` in response to user actions, or check `chart.indicators()` before adding one. See [Indicator persistence](/vela-pro/persistence/stores/indicators) for details on what each indicator type saves.
</Warning>

## Legend, settings, and panes [#legend-settings-and-panes]

Every mounted indicator displays a row in the legend of its target pane. Hovering over the row reveals actions to toggle visibility, open settings, remove the indicator, or select **Move to** to move the indicator into another pane or merge it with an existing one. On native and Pine Script® legend rows, Vela Pro adds a star button to save the indicator in the menu's favorites. Pine Script® rows also include an **Edit code** button that loads the script into the code editor.

The settings dialog is generated automatically from the indicator's input schema, whether declared via `input.*` calls in a script or `inputsSchema()` on a native descriptor. Strategy scripts also receive a Properties tab for declaration parameters such as initial capital.

Overlay indicators render directly on the price pane, while non-overlay indicators open a separate pane below the price pane. Users can reorder, collapse, or maximize panes using the pane header controls, and resize panes by dragging the divider between them. You can perform the same actions programmatically through `chart.panes` and the `IndicatorHandle` methods (`setVisible`, `moveTo`, `setInput`, `remove`); see the core [API reference](/vela/user/api-reference#indicatorhandle).

## In this section [#in-this-section]

<CardGroup cols="2">
  <Card title="Built-in indicators" href="/vela-pro/indicators/included">
    Classic studies from the core, native order-flow indicators, and LuxAlgo library families.
  </Card>

  <Card title="Indicator menu" href="/vela-pro/indicators/library">
    Menu layout, search, user favorites, and custom catalog tabs.
  </Card>

  <Card title="Pine Script® with PineTS" href="/vela-pro/indicators/pine/runtime">
    Engine configuration, library resolvers, footprint feeds, and programmatic script execution.
  </Card>

  <Card title="Custom indicators" href="/vela-pro/indicators/custom-indicators">
    Authoring Pine Script® studies, workspace manifests, and TypeScript native indicators.
  </Card>

  <Card title="Pine code editor" href="/vela-pro/indicators/pine/code-editor">
    Editor configuration and the controller API for custom save, review, and history workflows.
  </Card>

  <Card title="Custom runtimes" href="/vela-pro/indicators/runtimes/engines">
    Implementing and registering a custom scripting engine alongside Pine Script®.
  </Card>

  <Card title="Charting adapters" href="/vela-pro/indicators/runtimes/charting-adapters">
    Mapping indicator calculations to series, drawings, custom canvas layers, and chart types.
  </Card>
</CardGroup>
