Skip to content

Architecture Decision Records

Architecture Decision Records (ADRs) capture the significant technical decisions made while building chartgen. Each one describes the context that forced the decision, the options considered, and the consequences of the choice. The goal is that a contributor arriving six months from now — or the author’s future self — can reconstruct the why, not just the what.

Write an ADR when a decision has long-term consequences and more than one viable option: transport protocols, frameworks, auth models, data-contract shape, persistence layers, a major dependency. Keep them short. Ship the ADR in the same pull request as the code that implements the decision — never after the fact.

chartgen uses MADR 3.0 as the ADR format. Naming is sequential: NNNN-kebab-title.md. Statuses move through proposed → accepted → deprecated | superseded by NNNN. ADRs are immutable once merged; to revisit a decision, write a new ADR that supersedes the old one and link both ways.

#TitleStatusDate
0001Record architecture decisionsAccepted2026-04-19
0002MCP transport: Streamable HTTP 2025-03-26Accepted; amended by 00742026-04-19
0003Web frontend stack: SolidJS + TanStack Query + Kobalte + Tailwind v4Accepted2026-04-19
0004Type safety: codegen from MCP schemas + Zod at boundaryAccepted2026-04-19
0005Client-side indicator state with localStorage persistenceAccepted2026-04-20
0006TradingView visual parity for the web frontendAccepted2026-04-19
0007Complete series serialization: fills, hbars, divlinesAccepted2026-04-19
0008End-to-end tests with Playwright + CI integrationAccepted; amended by 0039 and 00572026-11-04
0009Live tail polling and history pagingAccepted2026-11-04
0010Overlay geometry rendering via klinecharts indicator draw callbacksAccepted2026-11-04
0011Watchlist quotes: batched get_quotes, rolling 24 h change for BinanceAccepted; amended by 00762026-11-04
0012Geometry colors on the wireAccepted2026-11-04
0013Indicator visibility, parameter editing and one instance per indicatorAccepted; superseded in part by 0028 and 00532026-11-04
0015Named chart layoutsAccepted2026-11-04
0016Light theme with a single TypeScript token sourceAccepted2026-11-04
0017Indicator plot stylesAccepted2026-11-05
0018Pine v5 semantics for indicator mathAccepted2026-11-05
0019Chart settings: per-theme overrides over the paletteAccepted2026-11-05
0020Client-side price alertsAccepted2026-11-05
0021Real-time chart push over the MCP SSE streamAccepted; amended by 0043, 0044 and 00742026-11-05
0022Compare symbolsAccepted2026-11-05
0023Bar replay: client slice, server recompute of repainting indicatorsAccepted2026-11-05
0024Starlark as the script runtime for user indicatorsAccepted2026-11-05
0025Per-user indicator registry and MCP surfaceAccepted2026-11-05
0026Line and histogram colors on the wireAccepted2026-11-05
0027Serve the web app from the MCP server’s originAccepted; amended by 00622026-11-05
0028Several instances of one indicatorAccepted2026-11-05
0029Shareable chart links as query parametersAccepted2026-11-05
0030Chart types klinecharts does not drawAccepted2026-11-05
0031Multiple named watchlists, sections and flagsAccepted2026-11-05
0032Indicator-aware warmupAccepted2026-11-05
0033Indicator projection past the last barAccepted; superseded in part by 00382026-11-05
0034Drawing and indicator alertsAccepted2026-11-05
0035Styleable indicator geometry colorsAccepted2026-11-05
0036Redirect an unknown OAuth client back to the server’s own web appAccepted2026-11-06
0037Pull-based deploy from the hostAccepted; superseded in part by 00602026-11-06
0038Custom intervals and session-aware future barsAccepted2026-11-06
0039Compact layout for phones and small tabletsAccepted2026-11-06
0040A layout stores the scale mode its compare symbols return toAccepted2026-11-06
0041Script editor in the web appAccepted2026-11-06
0042Alerts that run on the server, with webhooksAccepted2026-11-06
0043Multi-chart grid: per-pane store instances behind an active-chart APIAccepted2026-11-06
0044Sign-in through GitHub and GoogleAccepted; superseded in part by 0050; amended by 0058 and 0062 and 00632026-11-06
0045Browser push for server alertsAccepted2026-11-06
0046Pattern detection: candlesticks, chart patterns, auto fibAccepted; amended by 00552026-11-06
0047Price-based charts: Renko, Kagi, Point & Figure, Line Break, RangeAccepted2026-11-06
0048Order flow from lower-timeframe bars: footprints, TPO, volume profilesAccepted2026-11-06
0049One Binance kline read per symbol and intervalAccepted2026-11-06
0050A signed-in user’s workspace, on any deviceAccepted; amended by 00632026-11-07
0051What one connection may costAccepted2026-11-07
0052What an indicator costsAccepted2026-11-07
0053A hidden indicator stays in the status lineAccepted2026-11-08
0054An agent draws with the web app’s toolsAccepted2026-11-08
0055Provisional swing ends in zigzag and auto fibAccepted2026-11-09
0056A png or summary reads its indicators’ warmupAccepted2026-11-09
0057The e2e suite runs in duration-balanced CI shardsAccepted2026-11-09
0058Refresh tokens, so a client authorized once keeps workingAccepted2026-11-11
0059A setup is a stored record, scored on paper by the serverAccepted; amended by 0066, 0068, 0070, 0071 and 00722026-11-11
0060The production image is built in CI and pulled by the hostAccepted; superseded in part by 00752026-11-11
0061An alert can wake the owner’s agentAccepted; amended by 0067 and 00722026-11-11
0062Other origins get an answer on the MCP and OAuth client routes only, and the app is not framedAccepted2026-11-11
0063A read-only operator page, for a signed-in operator in the web app onlyAccepted2026-11-11
0064A setup states what it was made with, once, and the record is read back as countsProposed; amended by 00772026-11-11
0066Fixed shadow exit variants on every filled setupAccepted2026-11-12
0067Server alerts on an indicator’s line, at bar closesAccepted2026-11-12
0068Replay over real Binance historyAccepted (phase 1); phases 2 and 3 proposed2026-11-12
0069An alert at a bar’s closeAccepted2026-11-13
0070Setups on US stocks, scored on Yahoo’s 1m barsAccepted2026-11-14
0071A Setups panel in the web appAccepted2026-11-14
0072A wake-up carries the market around it, and a take near its stop wakes the agentAccepted; amended by 00732026-11-14
0073A symbol that is not trading has no market contextAccepted2026-11-14
0074After a restart, a client hears that the tools may have changedAccepted2026-11-15
0075The autodeploy follows a deployment until the platform finished itAccepted2026-11-15
0076get_quotes marks a quote that is not trading as staleAccepted2026-11-15
0077A setup records the market context it was made inAccepted2026-11-15