imp_trading_chart 0.1.2

A high-performance trading chart engine for Flutter with CustomPainter rendering, optimized for large datasets, real-time updates, and smooth pan & zoom.

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)

---

🤝 Contributing

We welcome contributions! Please see our CONTRIBUTING.md for guidelines on how to get started, project structure, and our CODE_OF_CONDUCT.md.

For a deep dive into the engine's internals, check out ARCHITECTURE.md.

📌 Stability & Versioning

This project follows Semantic Versioning (semver).

• v0.x.x: Public API is considered stable but minor breaking changes may occur in minor versions while we approach 1.0.
• Internal APIs: Everything under lib/src/ is considered internal and is not part of the stable public API. Use with caution.

📄 License

MIT License. See LICENSE for details.