call_ui_kit 0.6.0

A ready-to-use Flutter call UI kit for personal audio, video, and group calls.

0.6.0

Every size the kit lays out is now configurable. It used to hard-code all of them, so a host could restyle the colours and the text but never the metrics.

Added

• CallDimensions — the sizing counterpart to CallTheme. Pass it to CallScreen, IncomingCallScreen or OutgoingCallScreen. It composes one token class per surface, so a host names the metric it wants instead of reaching into a widget it cannot see:

  CallScreen(
    dimensions: const CallDimensions(
      bottomBar: CallBottomBarDimensions(
        buttonSize: 56,        // was 50
        endCallButtonSize: 72, // was 58
      ),
      pip: CallPipDimensions(size: Size(120, 160)), // was 90x120
    ),
    ...
  )
  

• Fourteen token classes, each with copyWith, == and hashCode, covering all 138 metrics the kit lays out: CallTopBarDimensions, CallBottomBarDimensions, CallRightButtonsDimensions, CallVideoContentDimensions, CallParticipantTileDimensions, CallThumbnailRowDimensions, CallPipDimensions, CallConnectionBannerDimensions, CallScreenShareBannerDimensions, CallParticipantsPanelDimensions, CallMoreSheetDimensions, CallHandleBarDimensions, CallIncomingScreenDimensions and CallOutgoingScreenDimensions.

• CallDimensions.scale — a multiplier over every token, for enlarging the whole UI at once. The kit's sizes are raw logical pixels, which suit a phone at reading distance but leave the controls smaller than the rest of a tablet host. It composes with the tokens: endCallButtonSize: 72 at scale: 1.25 renders 90.

• CallDimensions.compact() and CallDimensions.comfortable() presets. compact() is the kit's original phone layout; comfortable() is sized for a tablet, or for a device used at arm's length and in gloves.

• CallDimensions.rightButtonsHeight, alongside topBarHeight, bottomBarHeight and connectionBannerHeight. A host composing its own overlay has to reserve the same space, and the layer widgets are not exported.

• dimensions on every exported widget — ParticipantTile, FloatingPipView, MoreBottomSheet, ParticipantsPanel, ConnectionStateBanner, ScreenShareBanner, HandleBar — defaulting to const CallDimensions().

• SpeakingIndicator.gap. The bar spacing was hard-coded as 2 in two independent places, so a wider barWidth left the cluster too tight and the two literals could drift apart.

Improvements

• CallScreen derives its PiP insets from the dimensions rather than from static bar heights, so the PiP keeps clear of the controls at any size.
• Tap targets in CallTopBar follow the icon size. IconButton would otherwise stay at its default 48 px however large the glyph grew.
• The participant tile's speaking border and the group grid's gutters were bare literals in the middle of a build method. They are tokens now — still hairlines by default, and still exempt from scale, but no longer unreachable.

Breaking

• CallTopBar.height, CallBottomBar.height and ConnectionStateBanner.height are replaced by CallDimensions.topBarHeight, .bottomBarHeight and .connectionBannerHeight. A constant cannot follow a configurable size, and leaving one behind is how a host ends up reserving the wrong space — see the 94 vs 102 bug fixed in 0.5.0.

Notes

• const CallDimensions() reproduces the 0.5.0 metrics exactly, so existing consumers see no visual change — the goldens pass unmodified, and call_dimensions_test.dart asserts every default against the number the kit used to hard-code.
• Four fields are deliberately exempt from scale, each documented where it is declared: CallPipDimensions.borderWidth, CallParticipantTileDimensions.speakingBorderWidth and CallVideoContentDimensions.gridGutter are hairlines, which should stay hairlines however large the rest grows; CallVideoContentDimensions.personalAvatarFontRatio is a ratio, and the avatar it multiplies is already scaled.
• Font sizes are still multiplied by the host's MediaQuery.textScaler. A large accessibility text scale combined with large font tokens can overflow the fixed-height bars.

0.5.0

Fixed

• Local video no longer shows as a transparent hole in the PiP — the frame had no background, so a renderer that stopped painting (a texture disposed by a reconnect) showed straight through. All external video widgets now sit on an opaque VideoSurface.
• Group video no longer goes stale after a reconnect: the cached participant list ignored videoWidget changes and kept rendering the disposed renderer.
• PiP no longer drifts to another corner when the controls fade. It still follows them WhatsApp-style, but now stores its corner instead of a pixel offset.
• Bottom bar no longer swallows taps and drags aimed at the PiP.
• Buttons still visibly fading out now respond to taps (300 ms dead window removed).
• Turning the local camera off no longer blanks the remote video after a tap-to-swap.
• Personal-call fallback no longer claims the remote party's camera is off.
• Screen-share banner now also appears in personal calls.
• Modal sheets pause the auto-hide timer and refresh with the call state instead of showing a snapshot.
• CallBottomBar.height was 94 while the bar measured 102, halving the gap the PiP keeps from the controls.

Added

• CallConnectionState and ConnectionStateBanner — pass connectionState for a persistent "Connecting…"/"Reconnecting…" banner. Adds CallStrings.connecting and CallStrings.reconnecting.
• callStatusListenable — for values that tick, such as a call timer. callStatusText makes the host setState, which rebuilds every video surface once per tick (30 rebuilds per 10 s with three participants); a listenable rebuilds only the status line.
• PipCorner, PipSnapCalculator.nearestCorner / offsetForCorner / clampToBounds.
• Golden tests for six layouts, and CI running format, analysis and tests.
• README: "Reconnection" and "Performance" sections.

Breaking

• Removed _VideoErrorBoundary (0.4.0) in favour of VideoSurface. It never worked: Flutter catches paint exceptions in RenderObject._paintWithContext without rethrowing, so an ancestor try/catch was never reached.
• CallScreen: removed isHandRaised and onRaiseHand, which were accepted and never used.
• FloatingPipView: controlsVisible is deprecated and ignored — pass visibility-dependent topBarHeight/controlsHeight instead.
• Internal layers: CallTopBar.callType and CallBottomBar.bottomPadding removed.

0.4.0

Performance

• Narrow LayoutBuilder scope in CallScreen — only FloatingPipView rebuilds on constraint changes instead of all 5 layers.
• Pre-compute allParticipants list in didUpdateWidget instead of allocating on every build.
• Add ValueKey to ParticipantTile in grid layouts for correct widget reuse across participant reorders.
• Add RepaintBoundary to ScreenShareBanner slide animation to isolate repaints.

Improvements

• Animate grid layout transitions with AnimatedPositioned (250ms easeOutCubic) — smooth tile repositioning when participants join or leave.
• Add Semantics to all call control buttons, ParticipantTile, and SignalStrengthIcon for screen reader accessibility.
• Add endCall, speaker, camera, moreOptions localisation strings to CallStrings.
• Extract controls visibility timer into _ControlsVisibilityController for cleaner CallScreen state management.
• Add defensive timer cancellation in _startHideTimer() to prevent timer leaks.
• Add _VideoErrorBoundary around externally-provided video widgets — catches rendering errors at the RenderObject level and shows a fallback instead of crashing the call screen.
• Add toString() to CallParticipant and CallTheme for easier debugging.
• Document why videoWidget/screenShareWidget are excluded from CallParticipant equality.

Breaking Changes

• CallBottomBar: now requires a strings (CallStrings) parameter for accessibility labels.
• CallVideoContent: new optional allParticipants parameter — pass a pre-built list to avoid per-build allocation.

0.3.1

Bug Fixes

• Fix remote video being hidden when local camera is turned off in personal (1-on-1) calls.

0.3.0

Improvements

• Wrap CallScreen Scaffold with SafeArea — all content now respects device insets automatically.
• Replace manual MediaQuery.paddingOf safe area handling with LayoutBuilder for accurate sizing.
• Remove EdgeInsets safeArea parameter from CallTopBar and CallBottomBar.
• Remove safeAreaLeft/Right/Top/Bottom parameters from FloatingPipView.
• Remove redundant SafeArea wrapper from CallVideoContent group call layout.

Breaking Changes

• CallTopBar: removed safeArea parameter.
• CallBottomBar: replaced safeArea parameter with bottomPadding (double).
• FloatingPipView: removed safeAreaLeft, safeAreaRight, safeAreaTop, safeAreaBottom parameters.

0.2.1

• Lower minimum SDK constraints from Dart ^3.11.3 / Flutter >=3.29.0 to Dart ^3.4.0 / Flutter >=3.22.0 for wider compatibility.

0.2.0

Performance

• Cache CallStrings.english() as CallStrings.englishDefaults to prevent cascading widget rebuilds.
• Extract speaking border animation into isolated StatefulWidget — ParticipantTile is now a StatelessWidget.
• Keep SpeakingIndicator in widget tree permanently and toggle via visible parameter instead of destroying/recreating the AnimationController.
• Skip rendering SignalStrengthIcon when signal strength is excellent (the default).
• Cache screen sharer name lookup in didUpdateWidget instead of scanning participants on every build.
• Add RepaintBoundary to FloatingPipView child to isolate video repaints during snap animation.
• Remove _DefaultStrings sentinel class (~60 lines of boilerplate).

Bug Fixes

• Show remote screen share content in personal (1:1) call layout — previously screenShareWidget was ignored outside group calls.

Breaking Changes

• CallScreen.strings is now nullable (CallStrings?). Pass null or omit to use English defaults. Previously accepted a non-null CallStrings with an internal sentinel.
• CallStrings.englishDefaults is a new cached static field — use it instead of CallStrings.english() when a stable reference is needed.

0.1.1

• Use GitHub-hosted screenshots to reduce package size.
• Exclude build artifacts from published package.

0.1.0

• Initial release.
• CallScreen widget for personal audio, personal video, and group calls.
• Adaptive group call layouts: 2x2 grid, 2x3 grid, speaker view, screen share view.
• Draggable PiP (Picture-in-Picture) view with corner snapping.
• Animated speaking indicators and speaking tile borders.
• Signal strength indicator per participant.
• Participants panel with host actions (mute, remove).
• Customizable "more" bottom sheet with encryption label.
• Screen share banner with stop button.
• Full theming via CallTheme with WhatsApp preset.
• Full localization via CallStrings with English defaults.
• Zero external dependencies.