Installation

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.17.6  # 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

Version	Release Date	Key Features
1.17.6	April 2026	Fixed tooltip flickering when moving the mouse over the same data point
1.17.5	February 2026	Dynamic chart padding optimization, memory leak patches, and geometry color priority fixes
1.17.4	February 2026	Example app UI overhaul with dark mode, 13 new palettes, and gesture fixes
1.17.3	February 2026	Fixed OrdinalScale inversion overflow and enhanced bar chart examples
1.17.2	December 2025	Fixed tooltip positioning when panning
1.17.1	December 2025	Fixed tooltips not working with interactive legends
1.17.0	December 2025	Bar chart positive/negative value styling with smart rounded corners and conditional colors
1.16.0	November 2025	Integer-only ticks for continuous scales
1.15.0	November 2025	Pinch, scroll wheel, and button-based zoom interactions
1.14.0	November 2025	Tick configuration for continuous scales
1.13.1	November 2025	Fixed label size calculation with default font size
1.13.0	November 2025	Optional Y-axis titles in legends
1.12.1	November 2025	Fixed right padding and secondary Y-axis alignment
1.12.0	November 2025	Boundary clamping for pan operations
1.11.1	October 2025	Fixed Y-axis bounds during X-axis panning
1.11.0	October 2025	Programmatic pan controller with panTo() and panReset() methods
1.10.3	October 2025	Scale padding fix for consistent chart sizing during pan operations
1.10.2	October 2025	Heat map color unification and bounds edge case validation
1.10.1	October 2025	Wilkinson labeling precision fix for large numbers
1.10.0	October 2025	Axis titles and bubble size guide with edge case validation
1.9.0	October 2025	Interactive & floating legends with click-to-toggle and custom positioning
1.8.1	October 2025	Bidirectional documentation links and enhanced developer experience
1.8.0	October 2025	Intelligent axis bounds with Wilkinson labeling algorithm
1.7.0	September 2025	Progress bar charts with advanced styles and documentation improvements
1.6.1	September 2025	MCP Server integration for AI coding assistants
1.6.0	September 2025	Gradient color support for enhanced visualizations
1.5.0	September 2025	Built-in legend support with dark mode compatibility
1.4.0	September 2025	Custom category colors with palette system
1.3.1	September 2025	Multi-series line chart rendering fixes
1.3.0	September 2025	Comprehensive bubble chart support
1.2.4	August 2025	Performance improvements and bug fixes
1.2.3	August 2025	Documentation reference updates
1.2.2	August 2025	Enhanced HeatMap text readability
1.2.1	August 2025	Dependencies update and pie chart screenshots
1.2.0	August 2025	Heat map chart support with animations
1.1.0	August 2025	Advanced label formatting system
1.0.1	July 2025	Grouped bar chart alignment fixes
1.0.0	July 2025	Comprehensive pie chart and donut chart support
0.9.4	July 2025	Web WASM compatibility improvements
0.9.3	July 2025	Documentation site launch
0.9.2	July 2025	Advanced pan control with visual clipping
0.9.0	July 2025	Enhanced SVG export implementation
0.8.0	July 2025	Area chart support
0.7.0	June 2025	Interactive panning system
0.6.0	June 2025	Interactive tooltips and click handlers
0.5.0	June 2025	Dual 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

Pub get fails

Make sure you’re running Flutter 1.17+ and Dart 3.0+:

flutter --version
dart --version

Import errors

Verify the import statement:

import 'package:cristalyse/cristalyse.dart';

Build issues on web

Make sure you’re using a supported browser (Chrome 80+, Firefox, Safari).

Performance on older devices

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.

Get Started

Chart Types

Features

Advanced

Quick Installation

Manual Installation

Verify Installation

Platform Support

Mobile

Desktop

Web

Framework

Requirements

Dependencies

Version History

Next Steps

Quick Start Guide

Troubleshooting

​Quick Installation

​Manual Installation

​Verify Installation

​Platform Support

Mobile

Desktop

Web

Framework

​Requirements

​Dependencies

​Version History

​Next Steps

Quick Start Guide

​Troubleshooting

Quick Installation

Manual Installation

Verify Installation

Platform Support

Requirements

Dependencies

Version History

Next Steps

Troubleshooting