class WuzuAvatar extends ConsumerStatefulWidget { const WuzuAvatar({ super.key, this.controller, this.artboard, // Which artboard to use (cat, bear, dog) this.collarColor, this.eyeColor, this.outfit, // Nested artboard variant this.hat, // Nested artboard variant this.background, // Nested artboard variant this.foreground, // Nested artboard variant // ... more properties this.stateMachine, this.size = 48.0, this.onTap, }); // ... properties @override ConsumerState<WuzuAvatar> createState() => _WuzuAvatarState(); } class _WuzuAvatarState extends ConsumerState<WuzuAvatar> { rive.File? _file; rive.RiveWidgetController? _riveController; rive.ViewModelInstance? _viewModelInstance; rive.ViewModelInstanceArtboard? _clothesBackProperty; rive.ViewModelInstanceArtboard? _clothesFrontProperty; rive.ViewModelInstanceArtboard? _hatFrontProperty; // ... more properties @override void initState() { super.initState(); _loadRiveFile(); } Future<void> _loadRiveFile() async { final data = await rootBundle.load('assets/rive/wuzu.riv'); final bytes = data.buffer.asUint8List( data.offsetInBytes, data.lengthInBytes, ); final file = await rive.File.decode( bytes, riveFactory: rive.Factory.rive, ); if (!mounted) return; setState(() { _file = file; _riveController = rive.RiveWidgetController( file, artboardSelector: rive.ArtboardSelector.byName(effectiveArtboard.value), stateMachineSelector: widget.stateMachine != null ? rive.StateMachineSelector.byName(widget.stateMachine!.value) : const rive.StateMachineDefault(), ); }); _initDataBinding(effectiveArtboard); } void _initDataBinding(WuzuArtboard effectiveArtboard) { if (_riveController == null || _file == null) return; // Bind by index (each artboard has its own ViewModel) _viewModelInstance = _riveController!.dataBind( rive.DataBind.byIndex(effectiveArtboard.index), ); if (_viewModelInstance == null) return; // Bind nested artboard properties _clothesBackProperty = _viewModelInstance!.artboard('clothes_back'); _clothesFrontProperty = _viewModelInstance!.artboard('clothes_front'); _hatFrontProperty = _viewModelInstance!.artboard('hat_front'); // ... more bindings // Set initial values _updateOutfit(); _updateHat(); // ... more updates } void _updateArtboard( rive.ViewModelInstanceArtboard? property, String prefix, WuzuVariant? variant, ) { if (property == null || variant == null || _file == null) return; final artboardName = '${prefix}_${variant.value}'; final bindableArtboard = _file!.artboardToBind(artboardName); if (bindableArtboard != null) { property.value = bindableArtboard; } } void _disposeDataBindingProperties() { _clothesBackProperty?.dispose(); _clothesFrontProperty?.dispose(); _hatFrontProperty?.dispose(); // ... dispose all properties _viewModelInstance?.dispose(); _riveController?.dispose(); } @override void dispose() { _disposeDataBindingProperties(); _file?.dispose(); super.dispose(); } @override Widget build(BuildContext context) { return SizedBox( width: widget.size * 1.378, height: widget.size, child: rive.RiveWidget( controller: _riveController!, fit: rive.Fit.contain, ), ); } }

// stats_page.dart - Root level route WuzuAvatar( controller: _avatarController, stateMachine: stateMachine, collarColor: profile.getCollarColor(Theme.of(context).brightness), eyeColor: profile.getEyeColor(), outfit: profile.equippedOutfitEnum, hat: profile.equippedHatEnum, size: _avatarSize, )

// diary_detail_screen.dart - Pushed via Navigator.push WuzuAvatar( collarColor: profile?.getCollarColor(brightness), eyeColor: profile?.getEyeColor(), outfit: profile?.equippedOutfitEnum, hat: profile?.equippedHatEnum, background: WuzuVariant.hide, foreground: WuzuVariant.hide, inner: WuzuVariant.hide, size: 48, )