Quick start

Fifteen-minute path from a first visit to plots, strategy stats, and optional live updates.

AXIS is a charting app you run in the browser (or install as a PWA / desktop app). You pick where candles come from, whether they keep updating, who runs your Pine Script™, and where scripts are saved. The status bar uses short chips for those four planes:

Abstract

1. Ensure AXIS is running (Installation).
2. Default-symbol candles paint on boot (no Load click). An empty chart with bars and 0 scripts shows a Run chip (default RSI / editor buffer).
3. Paste or write a minimal indicator / strategy, or keep the prefilled editor script.
4. Editor Run, or topbar Add to chart on first apply (Run when that script is already on the chart) → inspect overlays + Results.
5. Optionally enable Live.

Conceptual model

Interface surface

1. History on the chart

Boot fetches the default symbol for the active source. First-run does not wait on a Load click.

Topbar fields that matter:

Pick a watchlist row to switch the symbol. Status bar should move through loading → ready with bar count context. Topbar Load (download icon) is a one-shot refetch when you already have a symbol — not the first-run step.

CSV path: Source = CSV upload → pick file when prompted → bars inject via upload store.

Deep history: for multi-page backfill to a past date (background, with gap validation), open the Data panel — see Data Source Manager.

2. Minimal script

Open the editor (docked right by default). Example indicator:

//@version=6
indicator("AXIS smoke", overlay=true)
plot(close, "close")
plot(ta.sma(close, 20), "sma20")

Strategy smoke (events for Results → Strategy):

//@version=6
strategy("AXIS strat smoke", overlay=true)
longCond = ta.crossover(ta.sma(close, 10), ta.sma(close, 30))
if longCond
    strategy.entry("L", strategy.long)
if ta.crossunder(ta.sma(close, 10), ta.sma(close, 30))
    strategy.close("L")

Language semantics: PYNE runtime.

3. Run / Add to chart

Editor primary is always Run. Topbar primary is Add to chart on first apply and Run when that script already has an instance on the chart (caret: Add instance or built-in). Empty chart with candles and 0 scripts also shows a one-shot Run chip.

Pipeline:

1. Active engine run({ script, bars, config })
2. lastRun stored in memory (not fully persisted)
3. Results drawer opens
4. Chart applies overlay lines, trade markers, Pine drawings

Success: status “Completed in Nms”; plots on price pane (or dedicated indicator pane if non-overlay).

4. Read Results

Tabs:

Export: JSON run dump; trades CSV. Click a trade to scroll the chart to entry/exit time.

5. Live (optional)

Toggle Live. A stream plugin pushes bars; AXIS may re-run silently when needsRerun is set. Live off (stream: null, not a none plugin) freezes time. Mock poll works offline after engine warm-up.

6. Save a script (optional)

Manager → Script Library → name → Save. Backend is active storage (local default = IndexedDB). See Script library. Editor Pull / Push uses the same storage when configured for git/cloud.

7. Power tools (optional)

Worked example: offline lab

Wait for candles → Add to chart / Run smoke indicator → toggle Live. No Flask required.

Worked example: desk + Flask

make run in repo root; Vite or static AXIS as installed.

Invariants

• Empty editor Run is a no-op.
• Errors set status error and still populate Results Metrics/Raw when payload exists.
• Switching source auto-aligns default stream (e.g. mock-walk → mock-poll).

Failure modes

See also

• Compose recipes
• Strategy and results
• Troubleshooting