Workspace layout
Explore the seven layout regions of a Vela Pro workspace, which layer renders each region, and where to configure them.
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
| Region | Contents | Rendered by | Configured via |
|---|---|---|---|
| Topbar (top edge) | Symbol, timeframe, chart style, layout, Indicators, Indicator templates, Replay, undo, and redo | The core, with controls added by Vela Pro features | Workspace topbar option |
| Drawing toolbar (left edge) | Grouped drawing tools, measure, eraser, magnet, and drawing-mode lock | The core, enhanced with Vela Pro menus | Workspace 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 axes | The core | Core 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 core | Respective module or feature option |
| Side rail (right edge) | Screenshot action, side panel toggles, and bottom panel toggles | Vela Pro sideRail feature on the core sidebar | Vela Pro sideRail option |
| Bottom bar (below charts) | Date range presets, trading session toggle, clock and time zone selector, Chart settings | The core | Workspace bottombar option |
| Bottom dock (below bottom bar) | One active wide panel at a time (Trading panel, Strategy Tester, or custom panels) | Vela Pro bottomDock feature | Vela 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:
| Control | Behavior | Documentation |
|---|---|---|
| Symbol button | Opens Vela Pro's symbol search modal in place of the core picker | Symbol search |
| Timeframe | Displays starred timeframes as quick-select chips alongside a full interval dropdown | Timeframes and sessions |
| Chart style | Lists the built-in chart types followed by Footprint and TPO | Chart types |
| Layout | Opens the multi-chart grid picker and sync toggles (hidden when layout: false) | Sync links |
| Indicators | Opens Vela Pro's indicator menu, with an adjacent caret dropdown for favorited indicators | Indicator menu |
| Indicator templates | Saves active indicators as a preset and applies saved templates | Indicator templates |
| Replay | Enters bar replay mode or exits an active replay session | Bar replay |
| Undo, Redo | Steps backward or forward through a unified history stack for drawings and indicators | Managing 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.
| Panel | Source | Panel ID |
|---|---|---|
| Watchlist | Watchlist module (enabled by default) | vela-pro.watchlist |
| Alerts | Alerts module (enabled by default) | vela-pro.alerts |
| Order book | Order book module (enabled by default) | vela-pro.orderbook |
| Order panel | Trading module (opt-in) | vela-pro.order |
| Journal | Journal module (opt-in) | vela-pro.journal |
| Calendar | Calendar module (opt-in) | vela-pro.calendar |
| Pine editor | Pine code editor feature | vela-pro.code |
| Object tree, Data window | The core | objects, 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.
| Panel | Source | How it opens |
|---|---|---|
| Strategy Tester | Strategy tester feature | Opens automatically when a strategy produces a backtest, or via Strategy report in the legend |
| Trading panel | Trading 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.
Related
- Interface layout
- Responsive layout
- Keyboard shortcuts
- The workspace in the core documentation