Skip to main content

​
Quick Installation

Adding Cristalyse to your Flutter project is incredibly simple. Just run one command: 
flutter pub add cristalyse
That’s it! No complex setup, no additional configuration needed.

​
Manual Installation

If you prefer to add the dependency manually, update your pubspec.yaml:
pubspec.yaml
dependencies:
  flutter:
    sdk: flutter
  cristalyse: ^1.13.0  # Latest version
Then run: 
flutter pub get

​
Verify Installation

Create a simple test to verify everything is working:
lib/test_chart.dart
import 'package:cristalyse/cristalyse.dart';
import 'package:flutter/material.dart';

class TestChart extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return CristalyseChart()
      .data([
        {'x': 1, 'y': 2},
        {'x': 2, 'y': 3},
        {'x': 3, 'y': 1},
      ])
      .mapping(x: 'x', y: 'y')
      .geomPoint()
      .build();
  }
}
If this compiles without errors, you’re ready to go!

​
Platform Support

Cristalyse works on all Flutter-supported platforms:

Mobile

iOS 12+
Android API 21+

Desktop

Windows 10+
macOS 10.14+
Linux (Ubuntu 18.04+)

Web

Chrome 80+
Firefox
Safari

Framework

Flutter 1.17+
Dart 3.0+
Null Safety

​
Requirements

  • Flutter SDK: 1.17.0 or higher
  • Dart SDK: 3.0.0 or higher
  • Platforms: iOS, Android, Web, Windows, macOS, Linux

​
Dependencies

Cristalyse has minimal dependencies to keep your app lightweight:
  • flutter (SDK)
  • path_provider (for SVG export functionality)
  • flutter_svg (for vector graphics support)

​
Version History

VersionRelease DateKey Features
1.13.0November 2025Optional Y-axis titles in legends
1.12.1November 2025Fixed right padding and secondary Y-axis alignment
1.12.0November 2025Boundary clamping for pan operations
1.11.1October 2025Fixed Y-axis bounds during X-axis panning
1.11.0October 2025Programmatic pan controller with panTo() and panReset() methods
1.10.3October 2025Scale padding fix for consistent chart sizing during pan operations
1.10.2October 2025Heat map color unification and bounds edge case validation
1.10.1October 2025Wilkinson labeling precision fix for large numbers
1.10.0October 2025Axis titles and bubble size guide with edge case validation
1.9.0October 2025Interactive & floating legends with click-to-toggle and custom positioning
1.8.1October 2025Bidirectional documentation links and enhanced developer experience
1.8.0October 2025Intelligent axis bounds with Wilkinson labeling algorithm
1.7.0September 2025Progress bar charts with advanced styles and documentation improvements
1.6.1September 2025MCP Server integration for AI coding assistants
1.6.0September 2025Gradient color support for enhanced visualizations
1.5.0September 2025Built-in legend support with dark mode compatibility
1.4.0September 2025Custom category colors with palette system
1.3.1September 2025Multi-series line chart rendering fixes
1.3.0September 2025Comprehensive bubble chart support
1.2.4August 2025Performance improvements and bug fixes
1.2.3August 2025Documentation reference updates
1.2.2August 2025Enhanced HeatMap text readability
1.2.1August 2025Dependencies update and pie chart screenshots
1.2.0August 2025Heat map chart support with animations
1.1.0August 2025Advanced label formatting system
1.0.1July 2025Grouped bar chart alignment fixes
1.0.0July 2025Comprehensive pie chart and donut chart support
0.9.4July 2025Web WASM compatibility improvements
0.9.3July 2025Documentation site launch
0.9.2July 2025Advanced pan control with visual clipping
0.9.0July 2025Enhanced SVG export implementation
0.8.0July 2025Area chart support
0.7.0June 2025Interactive panning system
0.6.0June 2025Interactive tooltips and click handlers
0.5.0June 2025Dual Y-axis support

​
Next Steps

Now that you have Cristalyse installed, let’s create your first chart:

Quick Start Guide

Build your first chart in 30 seconds

​
Troubleshooting

Make sure you’re running Flutter 1.17+ and Dart 3.0+:
flutter --version
dart --version
Verify the import statement:
import 'package:cristalyse/cristalyse.dart';
Make sure you’re using a supported browser (Chrome 80+, Firefox, Safari).
Cristalyse is optimized for modern devices. For older Android devices (API < 21), consider reducing animation complexity.
Need help? Check our GitHub Issues or start a discussion.