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: ^0.9.2  # 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
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

Need help? Check our GitHub Issues or start a discussion.