imp_trading_chart

A high-performance trading chart engine for Flutter
Inspired by TradingView Lightweight Charts

🚀 Overview

imp_trading_chart is a rendering-first trading chart engine for Flutter.

It is not a widget-heavy chart, but a CustomPainter + viewport-driven engine designed for performance, precision, and scalability.

Built specifically for:

📈 Financial & stock market apps
💹 Crypto & trading platforms
⚡ Real-time price feeds
🧠 Large datasets (10k+ candles)

✨ Visual Themes & Styles

🎬 Live Interaction Demos

🌎 Real App Integration

▶️ Full Market Simulation

✋ Drag / Pan Viewport

🔍 Pinch-to-Zoom

📊 Chart Variants

Variant	Use Case
Trading	Full-featured professional chart
Simple	Clean chart with labels
Compact	Dashboards & lists
Minimal	Sparklines & previews

🧠 Engine-First Architecture

Candle Data (List<Candle>)
        ↓
ChartEngine (viewport, scaling, mapping)
        ↓
CustomPainter (pixels only)

Why this matters

❌ No widget-per-candle
❌ No DateTime math in render loop
❌ No unnecessary rebuilds

✅ Only visible candles are processed ✅ Pan & zoom are O(1) operations ✅ Perfect for live trading data

📦 Installation

dependencies:
  imp_trading_chart: ^0.1.0

🚀 Basic Usage

ImpChart.trading(
  candles: candles
);

🕯 Candle Model

Candle(
  time: 1700000000,
  open: 100,
  high: 120,
  low: 90,
  close: 110,
);

⚠️ The engine does not aggregate data.

🧪 Example App

A complete interactive demo is included in the example/ folder.

cd example
flutter run

📚 Documentation

📘 Architecture & Internals → DOCUMENTATION.md
⚡ Quick API Guide → QUICK_REFERENCE.md

🔒 Public API Stability

Only these are public & stable:

ImpChart
Candle
ChartStyle
ChartLayout
LabelStyles

🚧 Roadmap

Public ChartController
Programmatic zoom / pan API
Indicator overlays (MA, EMA, VWAP)