PRICE · TIME · ENGINE

AXIS 2.5.0 / Open Charting PWA

OWNTHE AXES.SWAP THE ENGINE.

Name: HOOX
Author: HOOX

The chart you can own — sources, streams, engines, storage. Swap any piece without a proprietary host.

Unofficial · not affiliated with TradingView®, Inc. Not a TradingView® product.

Open AXIS Docs INIT CLI PYNE

AXIS charting PWA — candlestick chart, watchlist, and Pine editor on void chrome

Installable PWA
Compose plugins
Pine-compatible via PYNE
Self-host
AGPL v3

AXIS chart panes: BTCUSDT candles, volume, and RSI

01 // THESISSEC01

[COORDINATE SYSTEM]

AXIS 2.5.0 is an open charting PWA that treats price, time, and calculation as separable axes. Sources load history from 11 built-in venues plus 103+ CCXT exchanges. Streams advance the present via WebSocket. Engines evaluate Pine Script™ — Flask, Pyodide, or Cloudflare® Worker. Storage keeps your library. Six plugin kinds share one contract. Mobile-first shell on phones, full keyboard shortcuts on desktop. Compose any lawful combination; own AXIS under AGPL v3. Demo: axis.hoox.sh.

AXIS ≠ engine

The chart shell never embeds a closed interpreter. Evaluation is always a plugin — Flask on the desk, Pyodide offline, or a Cloudflare® Worker proxy at the edge. Swap engines without re-plumbing the watchlist.

Six-kind plugin registry

source, stream, engine, storage, dataset, component — all share one contract. Swap a venue without rewriting the editor; add on-chain data without forking the core.

Research, not wallpaper

Strategy events, equity metrics, hyperparameter optimization, 10 chart themes, advanced drawing tools, and CSV export ship as first-class panels — AXIS is a laboratory, not a locked display.

What AXIS is not

Not a closed hostNo proprietary charting lock-in around the bar loop.
Not a language rewriteFidelity lives in PYNE; AXIS is the coordinate system.
Not SaaS-onlySelf-host the PWA, the Pro API, or the Worker stack.
Not vapor edge PythonIn-worker Pyodide is planned; shipped path proxies today.

formal · identifiersAXIS.v1

Active set: { source, stream, engine, storage }
Contract: pynescript.axis.plugins.v1
State: pynescript.axis.v1
License: AGPL v3

[Thesis]

Thesis — section loads with JavaScript. Open docs

JavaScript is off. Read the documentation or install HOOX.

02 // SHIPPED SURFACESEC02

[FEATURE ATLAS]

Honest inventory of what ships in the AXIS PWA and its backends — not a roadmap teaser. Pick a domain on the map; entries map to registry kinds, shell chrome, language surface, and Worker API.

7domains62entriesshipped · example · planned marked in-panel

atlas · indexselect domain

Domain · UIAXIS shell

PWA chrome, chart host, editor, research panels — 16 entries

2 offline

01
Shelloffline
Installable PWA
pwa
manifest.webmanifest · service worker · void chrome (#0a0b10). Cache-first app shell; network-first for /api/*. Command palette (Cmd/Ctrl+K).
02
Mobileoffline
Mobile-first shell
mobile
Phone shell (≤767px): compact header + bottom tab bar (Chart · Panels · Editor · Studio · More), full-viewport panel sheets with swipe-down dismiss, force-single chart with slot switcher. Tablets get a scrollable topbar; desktop ≥1024px unchanged.
03
Keys
Keyboard shortcuts
shortcuts
Global chord dispatch hub with dialog-skip guard — app, chart, and editor scopes (line ops: duplicate, comment, indent, delete). Settings → Keyboard chord recorder with persisted overrides; Shortcuts modal lists defaults.
04
Chart
Multi-pane chart host
chart
TradingView® Lightweight Charts v5 — price, volume, indicator, and equity panes. Multi-chart layouts (2×2 grid). 10 curated themes (Void, Classic, Mono, Obsidian, Pacific, …).
05
Annotate
Drawing tools
draw
Trendline, horizontal/vertical/extended line, Fibonacci (retracement, extension, fan), Pitchfork, Brush, Callout, Gann, Pattern (XABCD, Head & Shoulders), Triangle, Channel, Ellipse, Arrow, Text, Price Label, Polyline, Linefill.
06
Runtime
Pine Script™ drawings
pine-draw
Lines, labels, boxes, polylines, and tables from the engine drawings payload. label.style_* with bubble tips, icon markers, yloc.abovebar/belowbar. Drawing GC for overflow.
07
Market
Watchlist + Venue Picker
watchlist
Detachable side rail with symbol list and session memory. Topbar Venue Picker: native CEX (Binance, OKX, Bybit, Coinbase, Kraken, MEXC), CCXT gateway (103+ exchanges), local.
08
Edit
CodeMirror 6 editor
editor
PYNE language mode (.pyne / .pine), multi-tab, pre-eval lint (idle 1s), call parameter intelligence, inline color chips, add type declarations, editor profiler, format document.
09
Overlay
Indicators panel
indicators
Multi-indicator cards; visible scripts re-run when live streams advance bars. fill() bands, barcolor(), bgcolor(), hline() with linestyle, plotshape/plotchar/plotarrow.
10
Export
Results panel
results
Events (Stream / Open⇄Close position-cycle views) · Strategy · Plots · Metrics · Raw — copy, JSON, and trades CSV. Hyperparameter Optimizer tab (TPE/random/grid via pyne POST /optimize).
11
Research
Strategy tester
strategy
Single-column report: P&L, win rate, return %, max drawdown, bars-held, fill counts; jump-to-bar from closed trades. Equity curve pane. Broker parameters (initial capital, commission, leverage, pyramiding). Saved runs show win %, PF, return %, max DD in the script library.
12
Pipeline
Data Source Manager
data-mgr
Multi-page OHLCV backfill, density validation, gap-fill, durable IndexedDB cache. Walk-back pagination with per-venue page sizes. 100K bar historical cap.
13
DeFi
On-chain data plane
onchain
Dataset plugins: DefiLlama TVL, GeckoTerminal DEX OHLCV. Worker proxy for allowlisted egress. TVL spike events, CSV export, popular protocol presets.
14
Config
Schema-driven settings
settings
Plugin configSchema fields become Settings controls — plugins self-describe. Editor intelligence settings (lint, hover, autocomplete, underline).
15
Ops
Studio UI
studio
Full-page overlay: Runtime, Wire (compose-recipe dialog), Plugins, Settings share one viewport with left rail. Workers Manager with health cards and inspector.
16
Ext
Plugin Manager
manager
Catalog with capability badges · Install from ES-module URL · Script Library tab. Six plugin kinds: source, stream, engine, storage, dataset, component.

[Atlas]

Atlas — section loads with JavaScript. Open docs

JavaScript is off. Read the documentation or install HOOX.

03 // COMBINATION SPACESEC03

[COMPOSE]

Plugins are orthogonal. Keep AXIS fixed; vary the active set. Default stream pairs follow the selected source — any lawful combination still works.

compose · formula∀ sets

∀Active set = { source, stream, engine, storage }

AXIS fixed · plugins orthogonal · registry contract unified. Default stream pairs follow source (e.g. mock-walk → mock-poll).

01Air-gap

Offline lab

Air-gapped research. Mock data, client-side Python, IndexedDB library — DevTools Offline still runs after first wheel load.

S: mock-walk
T: mock-poll
E: pyodide
St: local

02Dev

Desk research

Full pynescript fidelity on the laptop: Vite AXIS app + Flask Pro API. Live Binance bars, local script library.

S: binance-rest
T: binance-ws
E: server → Flask
St: local

03Swap

Multi-venue

Same AXIS, different venue. Flip source/stream pairs (OKX, Bybit, Coinbase, Kraken, MEXC) or route through CCXT gateway (103+ exchanges) without rewriting the editor or results panel.

S: okx-rest · bybit · kraken · mexc · ccxt
T: matching WS
E: server | pyodide | pyne-worker
St: local

04Own data

CSV backtest

Upload private OHLCV, evaluate with the server engine, export strategy metrics and trades CSV.

S: csv-upload
T: mock-poll
E: server → Flask
St: local

05Cloudflare®

AXIS at the edge

Pages-hosted PWA + Worker proxy. Keys in KV, optional D1 script library, Durable Object stream fan-out.

S: binance-rest
T: binance-ws | DO
E: server → Worker
St: cloud

06Git

Repo-as-library

Any data/engine combo with git storage — PYNE scripts as commits on GitHub or GitLab. Drafts stay local until Save.

S: any
T: any
E: any
St: git

07Ext

Plugin lab

Prove the ES-module contract: CoinGecko source + Tiny Pine engine examples via Manager Install URL — no core fork.

S: coingecko (ex.)
T: mock-poll
E: tiny-pine (ex.)
St: local

axis · compose model

CRT · 80×24

REGv1|KINDS4

Browser PWA  →  Sources · Streams · Engines · Storage
       │              (plugin registry)
       │              UDTs · libraries · methods · input.*
       ├─ Flask API (dev)
       ├─ Pyodide (offline)
       └─ Cloudflare® Worker + DO + KV + D1 + R2

Sources · Streams · Engines · StorageUTF-8|LF|AX

[Compose]

Compose — section loads with JavaScript. Open docs

JavaScript is off. Read the documentation or install HOOX.

04 // EVALUATION CONTRACTSEC04

[ENGINES]

Four calculation surfaces, one plugin contract. Language fidelity (UDTs, libraries, methods, inputs) travels with the engine, not the host. The server engine points at any compatible /run endpoint — desk Flask, edge Worker, or pyne-worker. Default exec mode is auto (try compile, fall back to interpret).

01Dev

Flask Pro API

Local research backend via make run. Full pynescript fidelity on your machine. Default endpoint http://localhost:5002.

02Offline

Pyodide (browser)

In-browser Python isolate. Self-hosted vendored pynescript wheel (~14MB, no CDN). Offline after first cache. Vendored pynescript 0.5.0.

03Edge

Cloudflare® Worker

POST /api/run proxies to EXTERNAL_BACKEND today. DO streams, KV keys/usage, optional D1 scripts and R2 bundles. WebSocket client with 45s dead cooldown.

04HOOX

pyne-worker

REST POST /run to HOOX pyne-worker (Python Cloudflare® Worker). Same evaluate contract: libraries, alerts, trade forwarding, script registry, bar-close cron.

ops · honestyNOTE

NOTE

In-worker Pyodide evaluation is planned (RUNTIME.md) and feature-gated. Do not assume zero-infra Python on the edge without the external backend until that path ships.

[Engines]

Engines — section loads with JavaScript. Open docs

JavaScript is off. Read the documentation or install HOOX.

05 // PERSISTENCESEC05

[SCRIPT LIBRARY]

Script libraries are plugins too. Pick IndexedDB for sovereignty, cloud for multi-device, or git when the repository is the source of truth.

01Default

Local

local

IndexedDB primary store with localStorage fallback. Offline by construction. Migrates SuperChart library keys on first open.

02Worker

Cloud

cloud

Bearer-authenticated /api/scripts. Partitioned by key hash. D1 schema optional; memory store for wrangler dev.

03VCS

Git

git

GitHub or GitLab Contents API. Commit + push on explicit Save. Personal access tokens stay in browser config — never server-side by default.

[Storage]

Storage — section loads with JavaScript. Open docs

JavaScript is off. Read the documentation or install HOOX.

06 // DECISION LOGSEC06

[DEV ADRs]

Architecture decisions that shaped AXIS. Short academic form: context, decision, consequences. Numbered for citation in ops notes and PRs.

adr · decision log13 entries

ADR-001

Pluggable four-kind registry

Context: Chart hosts that hard-code a single data feed or interpreter force forks for every venue or calc surface.
Decision: Unify source, stream, engine, and storage under one plugin base (id, kind, configSchema, capabilities) with active selection in the Solid store.
Consequences: Any lawful combination works without UI rewrites. Manager and Settings remain generic.

ADR-002

AXIS ≠ engine

Context: Closed charting products couple the bar loop to a proprietary host — authors cannot audit or relocate evaluation.
Decision: AXIS never embeds a closed interpreter. Evaluation is always an engine plugin; language fidelity is delegated to PYNE.
Consequences: Swap Flask, Pyodide, Worker proxy, or a custom engine without replacing AXIS.

ADR-003

Solid + Vite as product path

Context: The legacy SuperChart vanilla shell mixed concerns and lagged design tokens.
Decision: Ship the Solid/Vite app as the product UI. Retain the legacy shell for smoke tests only (LEGACY.md).
Consequences: One design language (void), typed store, and modern plugin path. Legacy is not marketed.

ADR-004

Dual calculation surfaces

Context: Researchers need offline sovereignty and operators need remote fidelity/ops controls.
Decision: Ship server (POST /run) and pyodide engines as first-class built-ins with identical RunResult contracts.
Consequences: Same results panel, drawings, and strategy export on both paths.

ADR-005

Config via schema

Context: Ad-hoc settings UIs do not scale as plugins accumulate fields (limits, base URLs, modes).
Decision: Each plugin declares configSchema; Settings renders controls from the schema.
Consequences: Plugins self-describe. No per-plugin Settings forks in AXIS.

ADR-006

Dynamic load by URL

Context: Contributors should extend AXIS without publishing to a central store or forking the monorepo.
Decision: Load ES modules via Manager Install URL; persist installed URLs in pynescript.axis.plugins.v1 and re-import on boot.
Consequences: Examples (CoinGecko, Tiny Pine, CF DO stream) live as files under public/plugins/.

ADR-007

Storage as plugin

Context: Script libraries span personal offline, multi-device cloud, and team git workflows.
Decision: Treat storage as a fourth plugin kind with list/read/write/remove (+ optional sync).
Consequences: Script Library tab switches backends without a second library UX.

ADR-008

Cloudflare® project id frozen

Context: Renaming Wrangler/Pages projects severs bindings, custom domains, and CI secrets.
Decision: Keep infrastructure id pynescript-superchart. User-facing brand is AXIS; health JSON may say pynescript-axis-worker.
Consequences: Deploy docs always use the stable project name. Optional axis.* aliases later.

ADR-009

Worker proxies first

Context: In-isolate Pyodide needs wheel packaging, cold-start budgets, and memory headroom.
Decision: Ship /api/run as a proxy to EXTERNAL_BACKEND. Scaffold in-worker Python behind a feature flag (RUNTIME.md).
Consequences: Production edge path works today with a Python host. Full CF-only evaluate remains planned.

ADR-010

Live fan-out via Durable Objects

Context: N browsers opening N upstream exchange sockets wastes quota and complicates reconnect.
Decision: Route /api/stream to a session Durable Object that holds one upstream WebSocket and fans bars to N clients.
Consequences: Hibernation-friendly live sessions; example plugin demonstrates the contract.

ADR-011

State namespace migration

Context: SuperChart → AXIS rename must not wipe user scripts, engines, or plugin installs.
Decision: Persist under pynescript.axis.v1 (and plugins.v1); migrate automatically from pynescript.superchart.* keys.
Consequences: Continuity for early adopters; single namespace going forward.

ADR-012

CORS explicit for Pro API

Context: Browser AXIS calling a separate origin requires controlled Access-Control-Allow-Origin.
Decision: Flask Pro reads ALLOWED_ORIGINS. Demo may use *; production should allowlist AXIS origins and localhost regex.
Consequences: Operators can tighten the VPS unit without code changes.

ADR-013

Results as first-class export

Context: Chart-only tools trap research in screenshots. Strategies need events, metrics, and CSV.
Decision: Five-tab Results panel (Events, Strategy, Plots, Metrics, Raw) with copy/JSON/trades CSV and jump-to-bar.
Consequences: AXIS is a research PWA — exportable, inspectable, host-independent.

[ADRs]

ADRs — section loads with JavaScript. Open docs

JavaScript is off. Read the documentation or install HOOX.

07 // TOPOLOGIESSEC07

[RUN SURFACES]

Where AXIS can run — from air-gapped browser to dual-process desk to Cloudflare® edge. AXIS is constant; the topology is chosen.

axis · topology

CRT · 80×24

PWAALWAYS|BACKENDOPT

┌─ Browser PWA (always) ─────────────────────────────────────┐
│  Sources · Streams · Engines · Storage · SW cache          │
└───────────────┬────────────────────────────┬───────────────┘
                │                            │
     engine=pyodide                    engine=server
     (no backend)                      POST /run
                │                            │
                │              ┌─────────────┴─────────────┐
                │              ▼                           ▼
                │     Local Flask (:5002)        Cloudflare® Worker
                │     make run                   /api/run proxy
                │                                DO /api/stream
                │                                KV · D1 · R2
                ▼
         Fully offline after wheel cache

Browser always · backend optionalUTF-8|LF|AX

01Primary dev

Local dual-process

Day-to-day development with HMR AXIS and full Python fidelity.

Depends · bun · Python · hoox-pyne

make -C ../pyne run  # :5002 (PYNESCRIPT_SRC if clone dir is pynescript)
bun run dev  # :3000

02Prod-like

Static dist + axis_pwa_server

Serve the built PWA without Cloudflare® Pages.

Depends · bun build · Python 3

bun run build
python3 axis_pwa_server.py  # :8081

03Live

Public demo

Shared public AXIS + Pro API for demos and smoke.

Depends · systemd · axis-pwa · pynescript-api

PWA  axis.hoox.sh
API  pynescript.online

Canonical demo host: axis.hoox.sh.

04Edge

Cloudflare® Pages + Worker

Global static AXIS with edge API, keys, streams, optional D1/R2.

Depends · wrangler · axis CLI · KV · (optional D1/R2)

bun run axis:install
bun run axis:deploy
# or: cd worker && wrangler deploy

Worker name pynescript-axis; project ids are frozen infrastructure — do not rename casually.

05Air-gap

Offline-only

No network after first load — research on untrusted or denied links.

Depends · Browser only (wheel cached)

Source=mock-walk · Stream=mock-poll · Engine=pyodide · Storage=local

06Mixed

Hybrid venue + remote calc

Public venue data in the browser; evaluate on desk Flask or Worker proxy.

Depends · Any source/stream + server engine endpoint

Set Endpoint → Flask or *.workers.dev · Engine=server

[Run]

Run — section loads with JavaScript. Open docs

JavaScript is off. Read the documentation or install HOOX.

08 // OPSSEC08

[DEPLOY]

Copyable make targets for the desk and the edge. Demo endpoints remain IP-first on HTTP until TLS lands on the VPS.

Demo PWA · axis.hoox.shAPI · pynescript.onlineINIT CLI

make · targetscopy

01Install (axis CLI)App + worker + CLI deps

02DoctorToolchain + wrangler.toml

03Dev PWA (Vite)HMR · proxies /run → :5002

04Build PWAVite Solid → dist/

05Serve distStatic AXIS on :8081

06Pro APIFlask PYNE on :5002 (PYNESCRIPT_SRC if clone dir is pynescript)

07Worker deployaxis CLI → pynescript-axis

08HealthLive /health (+ optional --oauth)

axis CLI

Operator entry (@hoox-sh/axis-cli): install, doctor, setup, secrets, deploy, health. Run via bun run axis … or packages/cli bin axis.

CORS

Pro API ALLOWED_ORIGINS (comma-separated). Demo may use *; production should list AXIS origins and a localhost regex.

Bindings

Provision KV API_KEYS + USAGE; optional D1 pynescript and R2 indicator-bundles before Worker deploy.

Demo

Public demo: https://axis.hoox.sh. Worker: pynescript-axis. AXIS package version 2.5.0.

[Deploy]

Deploy — section loads with JavaScript. Open docs

JavaScript is off. Read the documentation or install HOOX.

09 // CLOSESEC09

[OWN THE AXES]

Own the axes. Swap the engine. AXIS stays open.

axis · exit vectorsREADY

Open demo PWA INIT / Install CLI reference Clone AXIS PYNE runtime HOOX mesh

[Close]

Close — section loads with JavaScript. Open docs

JavaScript is off. Read the documentation or install HOOX.

02 // SHIPPED SURFACESEC02

[FEATURE ATLAS]

Honest inventory of what ships in the AXIS PWA and its backends — not a roadmap teaser. Pick a domain on the map; entries map to registry kinds, shell chrome, language surface, and Worker API.

7domains62entriesshipped · example · planned marked in-panel

atlas · indexselect domain

Domain · UIAXIS shell

PWA chrome, chart host, editor, research panels — 16 entries

2 offline

01
Shelloffline
Installable PWA
pwa
manifest.webmanifest · service worker · void chrome (#0a0b10). Cache-first app shell; network-first for /api/*. Command palette (Cmd/Ctrl+K).
02
Mobileoffline
Mobile-first shell
mobile
Phone shell (≤767px): compact header + bottom tab bar (Chart · Panels · Editor · Studio · More), full-viewport panel sheets with swipe-down dismiss, force-single chart with slot switcher. Tablets get a scrollable topbar; desktop ≥1024px unchanged.
03
Keys
Keyboard shortcuts
shortcuts
Global chord dispatch hub with dialog-skip guard — app, chart, and editor scopes (line ops: duplicate, comment, indent, delete). Settings → Keyboard chord recorder with persisted overrides; Shortcuts modal lists defaults.
04
Chart
Multi-pane chart host
chart
TradingView® Lightweight Charts v5 — price, volume, indicator, and equity panes. Multi-chart layouts (2×2 grid). 10 curated themes (Void, Classic, Mono, Obsidian, Pacific, …).
05
Annotate
Drawing tools
draw
Trendline, horizontal/vertical/extended line, Fibonacci (retracement, extension, fan), Pitchfork, Brush, Callout, Gann, Pattern (XABCD, Head & Shoulders), Triangle, Channel, Ellipse, Arrow, Text, Price Label, Polyline, Linefill.
06
Runtime
Pine Script™ drawings
pine-draw
Lines, labels, boxes, polylines, and tables from the engine drawings payload. label.style_* with bubble tips, icon markers, yloc.abovebar/belowbar. Drawing GC for overflow.
07
Market
Watchlist + Venue Picker
watchlist
Detachable side rail with symbol list and session memory. Topbar Venue Picker: native CEX (Binance, OKX, Bybit, Coinbase, Kraken, MEXC), CCXT gateway (103+ exchanges), local.
08
Edit
CodeMirror 6 editor
editor
PYNE language mode (.pyne / .pine), multi-tab, pre-eval lint (idle 1s), call parameter intelligence, inline color chips, add type declarations, editor profiler, format document.
09
Overlay
Indicators panel
indicators
Multi-indicator cards; visible scripts re-run when live streams advance bars. fill() bands, barcolor(), bgcolor(), hline() with linestyle, plotshape/plotchar/plotarrow.
10
Export
Results panel
results
Events (Stream / Open⇄Close position-cycle views) · Strategy · Plots · Metrics · Raw — copy, JSON, and trades CSV. Hyperparameter Optimizer tab (TPE/random/grid via pyne POST /optimize).
11
Research
Strategy tester
strategy
Single-column report: P&L, win rate, return %, max drawdown, bars-held, fill counts; jump-to-bar from closed trades. Equity curve pane. Broker parameters (initial capital, commission, leverage, pyramiding). Saved runs show win %, PF, return %, max DD in the script library.
12
Pipeline
Data Source Manager
data-mgr
Multi-page OHLCV backfill, density validation, gap-fill, durable IndexedDB cache. Walk-back pagination with per-venue page sizes. 100K bar historical cap.
13
DeFi
On-chain data plane
onchain
Dataset plugins: DefiLlama TVL, GeckoTerminal DEX OHLCV. Worker proxy for allowlisted egress. TVL spike events, CSV export, popular protocol presets.
14
Config
Schema-driven settings
settings
Plugin configSchema fields become Settings controls — plugins self-describe. Editor intelligence settings (lint, hover, autocomplete, underline).
15
Ops
Studio UI
studio
Full-page overlay: Runtime, Wire (compose-recipe dialog), Plugins, Settings share one viewport with left rail. Workers Manager with health cards and inspector.
16
Ext
Plugin Manager
manager
Catalog with capability badges · Install from ES-module URL · Script Library tab. Six plugin kinds: source, stream, engine, storage, dataset, component.

03 // COMBINATION SPACESEC03

[COMPOSE]

Plugins are orthogonal. Keep AXIS fixed; vary the active set. Default stream pairs follow the selected source — any lawful combination still works.

compose · formula∀ sets

∀Active set = { source, stream, engine, storage }

AXIS fixed · plugins orthogonal · registry contract unified. Default stream pairs follow source (e.g. mock-walk → mock-poll).

01Air-gap

Offline lab

Air-gapped research. Mock data, client-side Python, IndexedDB library — DevTools Offline still runs after first wheel load.

S: mock-walk
T: mock-poll
E: pyodide
St: local

02Dev

Desk research

Full pynescript fidelity on the laptop: Vite AXIS app + Flask Pro API. Live Binance bars, local script library.

S: binance-rest
T: binance-ws
E: server → Flask
St: local

03Swap

Multi-venue

Same AXIS, different venue. Flip source/stream pairs (OKX, Bybit, Coinbase, Kraken, MEXC) or route through CCXT gateway (103+ exchanges) without rewriting the editor or results panel.

S: okx-rest · bybit · kraken · mexc · ccxt
T: matching WS
E: server | pyodide | pyne-worker
St: local

04Own data

CSV backtest

Upload private OHLCV, evaluate with the server engine, export strategy metrics and trades CSV.

S: csv-upload
T: mock-poll
E: server → Flask
St: local

05Cloudflare®

AXIS at the edge

Pages-hosted PWA + Worker proxy. Keys in KV, optional D1 script library, Durable Object stream fan-out.

S: binance-rest
T: binance-ws | DO
E: server → Worker
St: cloud

06Git

Repo-as-library

Any data/engine combo with git storage — PYNE scripts as commits on GitHub or GitLab. Drafts stay local until Save.

S: any
T: any
E: any
St: git

07Ext

Plugin lab

Prove the ES-module contract: CoinGecko source + Tiny Pine engine examples via Manager Install URL — no core fork.

S: coingecko (ex.)
T: mock-poll
E: tiny-pine (ex.)
St: local

axis · compose model

CRT · 80×24

REGv1|KINDS4

Browser PWA  →  Sources · Streams · Engines · Storage
       │              (plugin registry)
       │              UDTs · libraries · methods · input.*
       ├─ Flask API (dev)
       ├─ Pyodide (offline)
       └─ Cloudflare® Worker + DO + KV + D1 + R2

Sources · Streams · Engines · StorageUTF-8|LF|AX

06 // DECISION LOGSEC06

[DEV ADRs]

Architecture decisions that shaped AXIS. Short academic form: context, decision, consequences. Numbered for citation in ops notes and PRs.

adr · decision log13 entries

ADR-001

Pluggable four-kind registry

Context: Chart hosts that hard-code a single data feed or interpreter force forks for every venue or calc surface.
Decision: Unify source, stream, engine, and storage under one plugin base (id, kind, configSchema, capabilities) with active selection in the Solid store.
Consequences: Any lawful combination works without UI rewrites. Manager and Settings remain generic.

ADR-002

AXIS ≠ engine

Context: Closed charting products couple the bar loop to a proprietary host — authors cannot audit or relocate evaluation.
Decision: AXIS never embeds a closed interpreter. Evaluation is always an engine plugin; language fidelity is delegated to PYNE.
Consequences: Swap Flask, Pyodide, Worker proxy, or a custom engine without replacing AXIS.

ADR-003

Solid + Vite as product path

Context: The legacy SuperChart vanilla shell mixed concerns and lagged design tokens.
Decision: Ship the Solid/Vite app as the product UI. Retain the legacy shell for smoke tests only (LEGACY.md).
Consequences: One design language (void), typed store, and modern plugin path. Legacy is not marketed.

ADR-004

Dual calculation surfaces

Context: Researchers need offline sovereignty and operators need remote fidelity/ops controls.
Decision: Ship server (POST /run) and pyodide engines as first-class built-ins with identical RunResult contracts.
Consequences: Same results panel, drawings, and strategy export on both paths.

ADR-005

Config via schema

Context: Ad-hoc settings UIs do not scale as plugins accumulate fields (limits, base URLs, modes).
Decision: Each plugin declares configSchema; Settings renders controls from the schema.
Consequences: Plugins self-describe. No per-plugin Settings forks in AXIS.

ADR-006

Dynamic load by URL

Context: Contributors should extend AXIS without publishing to a central store or forking the monorepo.
Decision: Load ES modules via Manager Install URL; persist installed URLs in pynescript.axis.plugins.v1 and re-import on boot.
Consequences: Examples (CoinGecko, Tiny Pine, CF DO stream) live as files under public/plugins/.

ADR-007

Storage as plugin

Context: Script libraries span personal offline, multi-device cloud, and team git workflows.
Decision: Treat storage as a fourth plugin kind with list/read/write/remove (+ optional sync).
Consequences: Script Library tab switches backends without a second library UX.

ADR-008

Cloudflare® project id frozen

Context: Renaming Wrangler/Pages projects severs bindings, custom domains, and CI secrets.
Decision: Keep infrastructure id pynescript-superchart. User-facing brand is AXIS; health JSON may say pynescript-axis-worker.
Consequences: Deploy docs always use the stable project name. Optional axis.* aliases later.

ADR-009

Worker proxies first

Context: In-isolate Pyodide needs wheel packaging, cold-start budgets, and memory headroom.
Decision: Ship /api/run as a proxy to EXTERNAL_BACKEND. Scaffold in-worker Python behind a feature flag (RUNTIME.md).
Consequences: Production edge path works today with a Python host. Full CF-only evaluate remains planned.

ADR-010

Live fan-out via Durable Objects

Context: N browsers opening N upstream exchange sockets wastes quota and complicates reconnect.
Decision: Route /api/stream to a session Durable Object that holds one upstream WebSocket and fans bars to N clients.
Consequences: Hibernation-friendly live sessions; example plugin demonstrates the contract.

ADR-011

State namespace migration

Context: SuperChart → AXIS rename must not wipe user scripts, engines, or plugin installs.
Decision: Persist under pynescript.axis.v1 (and plugins.v1); migrate automatically from pynescript.superchart.* keys.
Consequences: Continuity for early adopters; single namespace going forward.

ADR-012

CORS explicit for Pro API

Context: Browser AXIS calling a separate origin requires controlled Access-Control-Allow-Origin.
Decision: Flask Pro reads ALLOWED_ORIGINS. Demo may use *; production should allowlist AXIS origins and localhost regex.
Consequences: Operators can tighten the VPS unit without code changes.

ADR-013

Results as first-class export

Context: Chart-only tools trap research in screenshots. Strategies need events, metrics, and CSV.
Decision: Five-tab Results panel (Events, Strategy, Plots, Metrics, Raw) with copy/JSON/trades CSV and jump-to-bar.
Consequences: AXIS is a research PWA — exportable, inspectable, host-independent.

07 // TOPOLOGIESSEC07

[RUN SURFACES]

Where AXIS can run — from air-gapped browser to dual-process desk to Cloudflare® edge. AXIS is constant; the topology is chosen.

axis · topology

CRT · 80×24

PWAALWAYS|BACKENDOPT

┌─ Browser PWA (always) ─────────────────────────────────────┐
│  Sources · Streams · Engines · Storage · SW cache          │
└───────────────┬────────────────────────────┬───────────────┘
                │                            │
     engine=pyodide                    engine=server
     (no backend)                      POST /run
                │                            │
                │              ┌─────────────┴─────────────┐
                │              ▼                           ▼
                │     Local Flask (:5002)        Cloudflare® Worker
                │     make run                   /api/run proxy
                │                                DO /api/stream
                │                                KV · D1 · R2
                ▼
         Fully offline after wheel cache

Browser always · backend optionalUTF-8|LF|AX

01Primary dev

Local dual-process

Day-to-day development with HMR AXIS and full Python fidelity.

Depends · bun · Python · hoox-pyne

make -C ../pyne run  # :5002 (PYNESCRIPT_SRC if clone dir is pynescript)
bun run dev  # :3000

02Prod-like

Static dist + axis_pwa_server

Serve the built PWA without Cloudflare® Pages.

Depends · bun build · Python 3

bun run build
python3 axis_pwa_server.py  # :8081

03Live

Public demo

Shared public AXIS + Pro API for demos and smoke.

Depends · systemd · axis-pwa · pynescript-api

PWA  axis.hoox.sh
API  pynescript.online

Canonical demo host: axis.hoox.sh.

04Edge

Cloudflare® Pages + Worker

Global static AXIS with edge API, keys, streams, optional D1/R2.

Depends · wrangler · axis CLI · KV · (optional D1/R2)

bun run axis:install
bun run axis:deploy
# or: cd worker && wrangler deploy

Worker name pynescript-axis; project ids are frozen infrastructure — do not rename casually.

05Air-gap

Offline-only

No network after first load — research on untrusted or denied links.

Depends · Browser only (wheel cached)

Source=mock-walk · Stream=mock-poll · Engine=pyodide · Storage=local

06Mixed

Hybrid venue + remote calc

Public venue data in the browser; evaluate on desk Flask or Worker proxy.

Depends · Any source/stream + server engine endpoint

Set Endpoint → Flask or *.workers.dev · Engine=server

OWNTHE AXES.SWAP THE ENGINE.

[COORDINATE SYSTEM]

AXIS ≠ engine

Six-kind plugin registry

Research, not wallpaper

[FEATURE ATLAS]

Installable PWA

Mobile-first shell

Keyboard shortcuts

Multi-pane chart host

Drawing tools

Pine Script™ drawings

Watchlist + Venue Picker

CodeMirror 6 editor

Indicators panel

Results panel

Strategy tester

Data Source Manager

On-chain data plane

Schema-driven settings

Studio UI

Plugin Manager

[COMPOSE]

Offline lab

Desk research

Multi-venue

CSV backtest

AXIS at the edge

Repo-as-library

Plugin lab

[ENGINES]

Flask Pro API

Pyodide (browser)

Cloudflare® Worker

pyne-worker

[SCRIPT LIBRARY]

Local

Cloud

Git

[DEV ADRs]

Pluggable four-kind registry

AXIS ≠ engine

Solid + Vite as product path

Dual calculation surfaces

Config via schema

Dynamic load by URL

Storage as plugin

Cloudflare® project id frozen

Worker proxies first

Live fan-out via Durable Objects

State namespace migration

CORS explicit for Pro API

Results as first-class export

[RUN SURFACES]

Local dual-process

Static dist + axis_pwa_server

Public demo

Cloudflare® Pages + Worker

Offline-only

Hybrid venue + remote calc

[DEPLOY]

axis CLI

CORS

Bindings

Demo

[OWN THE AXES]

[COORDINATE SYSTEM]

AXIS ≠ engine

Six-kind plugin registry

Research, not wallpaper

[FEATURE ATLAS]

Installable PWA

Mobile-first shell

Keyboard shortcuts

Multi-pane chart host

Drawing tools

Pine Script™ drawings

Watchlist + Venue Picker

CodeMirror 6 editor

Indicators panel