# Vela™ (/vela)



![Vela™ — fast, extensible financial charts for the web](/images/vela/banner.png)

Vela™ is a modern charting library built around a small, robust **core** wrapped by three independently-extensible **layers**: **data providers** feed market data in, **scripting engines** execute indicators, and **renderers** draw the result. The core owns the canonical data and orchestrates everything; each layer plugs in behind a single narrow port, so you can swap any one of them without touching the others.

On top of the core, Vela™ ships a **workspace** (`@luxalgo/vela/workspace` — the batteries-included chart app) and a **plugin SDK** (`@luxalgo/vela/plugin`) that lets external packages extend both.

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

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

<CardGroup cols="2">
  <Card title="Quickstart" href="/vela/user/quickstart">
    Get a candlestick chart on screen, then add a scripting engine and an indicator.
  </Card>

  <Card title="The workspace" href="/vela/user/workspace">
    One chart or a multi-chart grid with shared chrome, sync links, and persistence.
  </Card>

  <Card title="Options" href="/vela/user/options">
    Market, display, drawings, settings, and per-indicator options.
  </Card>

  <Card title="API reference" href="/vela/user/api-reference">
    The public surface — the chart, handles, events, and control facades.
  </Card>

  <Card title="Drawing tools" href="/vela/user/drawing-tools">
    Interactive drawings, the toolbar, and the `chart.drawings` API.
  </Card>

  <Card title="Data providers" href="/vela/user/data-providers">
    Register providers, resolve symbols, and bring your own feed.
  </Card>

  <Card title="Scripting engines" href="/vela/user/scripting-engines">
    Vela™ ships no engine. Install Vela-PineTS or write your own.
  </Card>

  <Card title="Using with PineTS" href="/developers/pinets/using-within-charts">
    Display Pine Script indicators on a Vela™ chart via Vela-PineTS.
  </Card>

  <Card title="Plugin SDK" href="/vela/contributing/plugin-sdk">
    Chart types, renderer layers, native indicators, and widget actions.
  </Card>

  <Card title="Architecture" href="/vela/architecture/overview">
    One core, three layers, three ports — the shape of Vela™.
  </Card>

  <Card title="Examples" href="/vela/user/examples">
    Offline static and live examples, plus the in-repo playground.
  </Card>

  <Card title="FAQ" href="/vela/user/faq">
    Engines, offline data, live mode, drawings, and attribution.
  </Card>

  <Card title="View on GitHub" href="https://github.com/LuxAlgo/Vela">
    Star the repo, report issues, or contribute to Vela™.
  </Card>
</CardGroup>