Vela, our next-generation charting platform, is live at vela.luxalgo.com.
LuxAlgo

Workspace layout

Explore the seven layout regions of a Vela Pro workspace, which layer renders each region, and where to configure them.

View as Markdown

A desktop Vela Pro workspace is organized into seven layout regions. The outer shell is provided by Vela's open-source core, while Vela Pro adds the side rail and bottom dock, replaces the built-in symbol search and indicator picker behind the topbar controls, and populates side and bottom panels through its modules.

The layout described on this page corresponds to the default desktop configuration below:

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() },
    persist: true,
});

Workspace regions

RegionContentsRendered byConfigured via
Topbar (top edge)Symbol, timeframe, chart style, layout, Indicators, Indicator templates, Replay, undo, and redoThe core, with controls added by Vela Pro featuresWorkspace topbar option
Drawing toolbar (left edge)Grouped drawing tools, measure, eraser, magnet, and drawing-mode lockThe core, enhanced with Vela Pro menusWorkspace drawings and drawingToolbar options; Vela Pro drawingMenus and radialWheel
Chart area (center)A single chart or multi-chart grid, each with a status line, legend, panes, and axesThe coreCore chart options
Side panels (right of charts)One active panel at a time (Watchlist, Alerts, Order book, Pine editor, Object tree, Data window)Vela Pro modules, Pine code editor, and the coreRespective module or feature option
Side rail (right edge)Screenshot action, side panel toggles, and bottom panel togglesVela Pro sideRail feature on the core sidebarVela Pro sideRail option
Bottom bar (below charts)Date range presets, trading session toggle, clock and time zone selector, Chart settingsThe coreWorkspace bottombar option
Bottom dock (below bottom bar)One active wide panel at a time (Trading panel, Strategy Tester, or custom panels)Vela Pro bottomDock featureVela Pro bottomDock option

Vela Pro feature options are passed to enableVelaPro(), and workspace chrome options are passed to new VelaWorkspace(). See Interface layout to hide, disable, or reorder individual regions.

On narrow viewports, the workspace switches automatically to a mobile layout with a single bottom bar and slide-up sheets. See Responsive layout for mobile behavior. When enabled, the richTooltips feature renders control tooltips as structured cards displaying both a description and the associated keyboard shortcut.

Topbar

The left cluster of the topbar contains controls targeting the active chart, rendered in the following order:

ControlBehaviorDocumentation
Symbol buttonOpens Vela Pro's symbol search modal in place of the core pickerSymbol search
TimeframeDisplays starred timeframes as quick-select chips alongside a full interval dropdownTimeframes and sessions
Chart styleLists the built-in chart types followed by Footprint and TPOChart types
LayoutOpens the multi-chart grid picker and sync toggles (hidden when layout: false)Sync links
IndicatorsOpens Vela Pro's indicator menu, with an adjacent caret dropdown for favorited indicatorsIndicator menu
Indicator templatesSaves active indicators as a preset and applies saved templatesIndicator templates
ReplayEnters bar replay mode or exits an active replay sessionBar replay
Undo, RedoSteps backward or forward through a unified history stack for drawings and indicatorsManaging drawings

In a bare core workspace, the right cluster of the topbar holds the alerts bell, panel toggles, and the Download screenshot button. With Vela Pro's defaults, panel toggles and the screenshot button move into the side rail, and the rail's Alerts entry replaces the topbar bell, reserving the right cluster for custom host actions. Pass alerts: { topbarBell: true } to enableVelaPro() if you want to retain the bell in the topbar.

Use the workspace topbar option to filter or reorder topbar entries, as covered in Composing the topbar.

Drawing toolbar

A single drawing toolbar serves every chart in the workspace and applies to whichever chart cell is currently active. The core provides the tool group flyouts, cursor mode selector, measure tool, eraser, magnet toggle, and stay-in-drawing-mode lock. Vela Pro's drawingMenus feature upgrades each flyout into a searchable list with categorized tool cards, and radialWheel opens a radial picker of favorited tools while holding Alt.

See Drawing tools for toolbar configuration, favorites, and the radial wheel.

Chart area

Each workspace cell hosts a core chart instance containing four stacked elements:

  • Status line: Displays the symbol, venue, timeframe, market status, and the open, high, low, close, and change values for the bar under the crosshair. Right-click the status line to toggle individual fields.
  • Legend: Displays one row per active indicator with live plot values and action buttons. Vela Pro adds contextual controls to legend rows where applicable, including Edit code on Pine Script® indicators, a favorites star, Add an alert on script indicators, and Strategy report on strategies.
  • Panes: Renders the primary price pane at the top, followed by separate lower panes for non-overlay indicators. Drag the divider between two panes to resize them.
  • Axes: Renders a vertical price axis on the right of each pane and a shared horizontal time axis at the bottom, each with a context menu.

Hovering near the bottom center of a chart reveals floating viewport controls for zooming and resetting the view, plus a drag handle and maximize toggle in multi-chart grids. When the Trading module is installed, it adds a Buy/Sell order card beneath the status line and renders active orders and positions directly on the price pane.

Initial chart appearance comes from the core chart options, and users can adjust display preferences at runtime in Chart settings (see Options). Pass statusline: false on VelaWorkspace to hide the status line.

By default, the core renders an attribution mark in the bottom-left corner of each chart. enableVelaPro() disables this mark by default, and its watermark option can restore it or replace it with custom branding, as detailed in Theming and branding.

Two distinct options are named watermark. On enableVelaPro(), watermark controls the bottom-left corner attribution mark. On VelaWorkspace, watermark controls the core symbol watermark rendered in large faded text behind the price pane.

Side rail and side panels

The side rail builds on the core sidebar through Vela Pro's sideRail feature. Its upper group holds the Screenshot menu (download PNG or copy to clipboard) and toggle buttons for side panels. Its lower group holds Object tree, Data window, and toggle buttons for bottom dock panels.

Clicking a side panel button mounts that panel in a resizable column between the chart area and the side rail, narrowing the charts to fit. Only one side panel is open at a time, and any width adjusted via the inner drag handle is saved in the workspace state document.

PanelSourcePanel ID
WatchlistWatchlist module (enabled by default)vela-pro.watchlist
AlertsAlerts module (enabled by default)vela-pro.alerts
Order bookOrder book module (enabled by default)vela-pro.orderbook
Order panelTrading module (opt-in)vela-pro.order
JournalJournal module (opt-in)vela-pro.journal
CalendarCalendar module (opt-in)vela-pro.calendar
Pine editorPine code editor featurevela-pro.code
Object tree, Data windowThe coreobjects, dataWindow

Unlike the column panels, the Pine editor floats as an overlay along the right edge of the chart by default until the user clicks its header pin button to dock it into the side column.

Configure item order and visibility with enableVelaPro({ sideRail: { top, bottom, exclude } }) using the panel IDs above. Passing sideRail: false disables the side rail and returns panel buttons to the topbar. Custom panels registered with the SDK appear in the rail automatically, as shown in Custom panels and widgets.

Bottom bar

The bottom bar is rendered by the core. Its date range chips (1D through ALL) switch the active chart to a matching timeframe and fit the selected range. Beside the range chips sit the regular and extended session switch for session-aware markets, the live clock and Time zone picker, and a Chart settings shortcut.

Pass bottombar: false to VelaWorkspace to hide the bottom bar. Every control in this bar is documented in The chrome.

Bottom dock

The bottom dock is a collapsible horizontal container positioned below the bottom bar for wide tabular or analytical panels. It stays collapsed until a panel opens, displays one panel at a time, and can be resized from its top border or maximized over the chart area.

PanelSourceHow it opens
Strategy TesterStrategy tester featureOpens automatically when a strategy produces a backtest, or via Strategy report in the legend
Trading panelTrading module (opt-in)Toggled from its button in the side rail

Configure dock dimensions with enableVelaPro({ bottomDock: { height, minHeight, chartFloor } }), which sets the default open height (300 px), minimum panel height (140 px), and minimum height preserved for the chart area (220 px). Both the active bottom panel and any user-dragged height persist in the workspace state document.

On this page