radial_charts 0.2.0 copy "radial_charts: ^0.2.0" to clipboard
radial_charts: ^0.2.0 copied to clipboard

Customizable radial chart widgets for Flutter rating charts and rounded donut charts with legends, emojis, and smooth animations.

Changelog #

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased] #

0.2.0 - 2025-10-31 #

Added #

  • RoundedDonutChart - new chart type with smooth rounded segment edges
    • DonutSegmentData model for donut chart segments
    • DonutChartConfig for chart configuration (size, radii, colors)
    • Support for emoji in segments
    • Customizable legend styles (circle, rectangle, roundedRectangle)
    • Value display inside legend indicators
    • Custom text in chart center
  • Unified Legend System - shared legend architecture for both chart types
    • UnifiedLegend widget used by both RadialRatingChart and RoundedDonutChart
    • LegendItem - universal legend item model
    • Emoji support in legends for both charts
    • Consistent styles and behavior across charts
  • RadialRatingChart enhancements:
    • showRatingInLegend parameter to display rating values in legend
    • legendRatingStyle parameter for value text styling
    • Automatic indicator size adjustment when values are enabled
    • Emoji support in categories
  • Example app completely redesigned:
    • Two separate screens showcasing each chart type
    • Interactive settings (ChartSettings) with live preview
    • Editable segment/category cards
    • Material Design 3 interface
    • Modular structure (constants, models, screens, widgets)

Fixed #

  • RadialRatingChart: fixed vertical line appearing with only one category

Changed #

  • BREAKING: Both charts now use UnifiedLegend instead of separate implementations
  • BREAKING: LegendStyle enum moved from rounded_donut_chart/models/ to common/models/
  • Standardized spacing between charts and legends (spacing * 3)
  • Simplified RadialRatingChart API (removed maxRating, minRating, sortCategoriesById from widget parameters)
  • Example app: main.dart reduced from 395 lines to compact structure

Internal #

  • Created lib/src/common/ folder for shared components
  • Added architecture foundation for future chart types
  • Improved code modularity and reusability

Old [Unreleased] content (keeping for reference): #

  • RoundedDonutChart: New donut chart widget with rounded segment edges
    • Smooth Bezier curve transitions between segments for a polished look
    • Two-pass rendering algorithm for seamless rounded edges
    • Configurable center text with automatic total calculation
    • Three legend styles: circle, rectangle, and roundedRectangle
    • Optional count badges displayed inside legend indicators
    • Support for empty state and single-segment visualization
    • Fully customizable colors, sizes, radii, and text styles
  • New models for RoundedDonutChart:
    • DonutSegmentData: Flexible data model with id, value, color, label, and metadata
    • DonutChartConfig: Configuration for donut appearance and behavior
    • LegendStyle: Enum for legend indicator styles
  • New painters:
    • RoundedDonutPainter: Main painter for multiple segments with rounded edges
    • SingleItemDonutPainter: Optimized painter for single-segment charts
  • Comprehensive documentation for RoundedDonutChart in README
  • API reference documentation for all new components

Features #

  • Rounded edge algorithm using cubic Bezier curves with 4x radius enhancement
  • Automatic handling of edge cases (empty data, single segment, multiple segments)
  • Flexible center text: static string or dynamic builder function
  • Multi-column legend layout with configurable spacing
  • Support for metadata in segment data for custom use cases
  • Consistent API design matching existing RadialRatingChart pattern

0.1.3 - 2025-10-11 #

Fixed #

  • Fix screenshot display in README on both pub.dev and GitHub
  • Use absolute GitHub URLs for screenshots instead of relative paths
  • Screenshots now properly display in package documentation

0.1.2 - 2025-10-11 #

Fixed #

  • Fix screenshot display on pub.dev by removing spaces from filenames
  • Screenshots now properly display in package gallery and as thumbnail

0.1.1 - 2025-10-11 #

Changed #

  • Add screenshots gallery to pub.dev package page
  • Screenshots are now displayed in a dedicated gallery on pub.dev
  • First screenshot is used as package thumbnail

0.1.0 - 2025-10-11 #

Added #

  • Initial release of Radial Charts package
  • RadialRatingChart widget for displaying radial rating charts
  • ChartCategory model for defining categories
  • CategoryData model for category ratings
  • ChartConfig for customizing chart appearance
  • RadialChartPainter custom painter for rendering
  • Predefined category sets:
    • Life Balance categories (11 categories)
    • Skills Assessment categories (5 categories)
    • Product Features categories (5 categories)
  • Legend support with customizable layout
  • Configurable grid levels, colors, opacity, and borders
  • Support for variable radius segments based on ratings
  • Sorting categories by ID for consistent positioning
  • Zero external dependencies (pure Flutter)
  • Comprehensive documentation and examples
  • Example app with 4 different demo scenarios

Features #

  • Variable radius segments representing rating values
  • Highly customizable appearance (colors, grid, opacity, borders)
  • Optional legend with multi-column layout
  • Adaptive segment count (1 to N categories)
  • Special handling for single-category display (full circle)
  • Performance-optimized CustomPainter
  • Full control over start angle and grid levels
  • Support for emoji/icons in categories

Documentation #

  • Complete README with usage examples
  • API reference documentation
  • Multiple use case examples
  • Contributing guidelines
  • MIT License
5
likes
0
points
149
downloads

Publisher

unverified uploader

Weekly Downloads

Customizable radial chart widgets for Flutter rating charts and rounded donut charts with legends, emojis, and smooth animations.

Repository (GitHub)
View/report issues

License

unknown (license)

Dependencies

flutter

More

Packages that depend on radial_charts