muscle_map_flutter #

Muscle heatmap visualization widget for Flutter. Renders front/back body diagrams with colored muscle overlays using CustomPainter.

Features #

• Front and back body diagrams for male and female
• 4 color models: Load, Frequency, Balance, Recovery Risk
• Monochrome color scale (grey → brand color)
• Per-surface value overrides via PartValues
• Interactive hover/tap with muscle name + score tooltip
• Gradient legend bar
• Glow effects for active muscles
• CustomPainter-based rendering (zero external dependencies)

Installation #

Add to your pubspec.yaml:

dependencies:
  muscle_map_flutter:
    git:
      url: https://github.com/henrytran1803/muscle-map-flutter.git

Usage #

import 'package:muscle_map_flutter/muscle_map_flutter.dart';

// Basic usage
MuscleMap(
  values: {
    MuscleGroup.BICEPS_LEFT: MuscleMapValue(group: MuscleGroup.BICEPS_LEFT, value: 75),
    MuscleGroup.QUADRICEPS_RIGHT: MuscleMapValue(group: MuscleGroup.QUADRICEPS_RIGHT, value: 45),
  },
  sex: MuscleMapSex.MALE,
  view: MuscleMapView.FRONT,
  colorModel: MuscleColorModel.LOAD,
  figureWidth: 250,
  onSelectMuscle: (selection) {
    print('Selected: ${selection.group}, Score: ${selection.value?.value}');
  },
)

API Reference #

MuscleMap #

MuscleGroup enum (23 values) #

Left/right bilateral muscles: TRAPEZIUS_LEFT/RIGHT, DELTOID_LEFT/RIGHT, PECTORALIS_MAJOR_LEFT/RIGHT, BICEPS_LEFT/RIGHT, TRICEPS_LEFT/RIGHT, FOREARM_LEFT/RIGHT, OBLIQUES_LEFT/RIGHT, QUADRICEPS_LEFT/RIGHT, HAMSTRING_LEFT/RIGHT, GASTROCNEMIUS_LEFT/RIGHT, GLUTEUS_LEFT/RIGHT

Center: RECTUS_ABDOMINIS

Color Models #

Per-surface overrides #

MuscleMap(
  values: values,
  partValues: {
    'TRAPEZIUS_LEFT': 90,
    'BICEPS_RIGHT': 30,
  },
)

Additional Widgets #

// Standalone legend
MuscleMapLegend(
  colorModel: MuscleColorModel.LOAD,
  minLabel: 'Low',
  maxLabel: 'High',
)

// Low-level body figure
BodyFigure(
  diagram: getBodyDiagram(MuscleMapSex.MALE, MuscleMapView.FRONT),
  values: values,
  width: 200,
)

License #

MIT License. See LICENSE for details.