NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev
Spring-physics motion components for Flutter — a one-to-one port of the beUI React library, from switches and docks to shader backgrounds.
Latest stable
3.0.0
Last release 29 days ago
24 Oct 2026
Ships on a steady schedule
a new release about every 5 weeks
Nearly every release is documented
notes for 5 of 5 stable releases
Nothing withdrawn
no release was ever pulled
3 months old
5 releases · first in 2026
Drag across the ruler to compare, or tap a release to open it.
beUI 3.0.0 integrates the remaining v3 catalog families into one package: motion components, blocks, agents, and charts.
beUI 3.0.0 integrates the remaining v3 catalog families into one package: motion components, blocks, agents, and charts.
side: "yes" for every row, including rows displaying No, matching the source preview. The callback signature is unchanged.BeuiTextTheme defaults now name Geist and Geist Mono. Consumers must provide those fonts; the package still bundles no font assets.BeuiMetallicButton, BeuiTextScramble, BeuiDigitSwap and BeuiInlineSlider.always / selected) plus overflow chevrons; tooltip gains arrow, align, disabled, BeuiTooltipProvider, followCursor and collision-aware flip.reserveErrorLine so validation does not shift nearby content.onCellEdit, onEndReached).BeuiTableSizing, BeuiTableIntrinsicSample). It also keeps collapsed grid geometry, menus, native keyboard input and the initial drag displacement.BeuiProjectFolder) — file fan on hover/focus that morphs into a focus-managed overlay grid; folder rotateX springs with the fan.BeuiCardFolder) — landscape card in a stitched purse pocket, with DigitSwap details and an optional overflow action.BeuiMorphingSearch, BeuiMorphingSearchChips) — field or icon that morphs into results, plus a chip search bar with recents. The docked bar stays hittable while recents are open. Gallery slug morphing-search-chips isolates Chip Search.BeuiMorphingTabs) — reorderable tabs whose selected item grows into a cream content surface on charcoal chrome (#292929 / #fafaf8). Inactive tabs pack left with a hover fill.BeuiSignUpForm) — composed registration with punish-late field errors, strength meter, and a stateful submit.BeuiPredictionMarketCard) — listing cards with a single odds pill (percent at rest, Yes/No on hover), payout multipliers, volume sparkline, and bookmarks, stacked with the existing trade ticket. Gallery slug prediction-market-card isolates the listing.BeuiVoiceOrb — breathing liquid voice visualization with flowing
highlights, custom pigments, a voice-reactive silhouette, a caller-owned
analyser, offscreen pause, a reduced-motion freeze, and a size override
(default w-64 / 256; the live preview uses sm:w-72 / 288).BeuiChartTicker for digit animation.BeuiSankeyChart — weighted flows between stages that draw in and morph with the data, with hover and keyboard inspection.BeuiTreemap — order-preserving binary tiles that spring to new sizes, with path tooltips and a group legend.BeuiCandlestickChart — OHLC candles with a live last price, volume, and keyboard inspection.BeuiDonutChart — round-capped ring with a live center, legend, and sweep-in motion.BeuiVolumeProfile — volume-by-price bins with POC and a value-area highlight.BeuiStatusBar — proportional incident bar with operational / degraded / outage statuses.BeuiCompositionChart — 100% stacked bar or area composition across periods.BeuiFunnelChart — conversion funnel with curved morphs and drop-off tooltips.BeuiLiquidityHeatmap — order-book liquidity bands over time with a cubic price trace through adjacent row centers.BeuiBumpChart — ranking bump chart with curved series that break on missing periods.BeuiOrderBook — live bid/ask depth tables, spread, and a balance bar; rest depth bars fill the row height.BeuiHeatCalendar — GitHub-style contribution heatmap with range selection; filtered cells fade; 16-week legends place the date range opposite less/more.BeuiReturnsCalendar — monthly returns grid with gain/loss tint and compounded totals; month labels use JS Math.round.BeuiPriceTargetFan — high/mean/low target fan over a history path.Install: flutter pub add beui · pub.dev · Live gallery
Your coding agent can read these notes before it upgrades. Set up the MCP server →
One column per month.
It is a major because the dead and deprecated API below is deleted rather than kept.
Codebase slop audit. No component was redesigned; this release removes duplication, dead code, and process residue that accumulated across the 1.x agent passes, and fixes the bugs found on the way. It is a major because the dead and deprecated API below is deleted rather than kept.
beuiSidebarCanContain (use BeuiSidebarResource.canContain) and
citationTargetId.BeuiGlass.strongBg, thinBg, strongBlur, thinBlur — no component
rendered them; bg, border and blur remain.BeuiAgentLayout.density and BeuiAgentDensity — no component branched
on them; BeuiAgentTheme.compact still tightens the spacing tokens.BeuiCodeBlock.filenameNode,
BeuiFileDiff.fileNode and BeuiPreviewRailStyle.trackExtent; use
filename/filenameWidget, file/fileWidget and itemSize.@visibleForTesting
internals.pub get no longer fails to compile: flutter_lucide renamed
trash_2 to trash in 1.41 and rotate_ccw_clock only exists from
1.31, so the lower bound is now >=1.41.0 and the glyph is renamed.BeuiAgentTheme.decorateCard passed the glass palette's 20px CSS radius
straight in as a Gaussian sigma, rendering at twice the source blur.MaterialApp without the BeuiColors extension no longer throws in
36 components, and two components no longer fall back to the light
palette in dark mode: every lookup goes through BeuiColors.resolve.BeuiRangeSlider adopts the shared slider state, so a range whose max
is not a step multiple can reach it, fractional steps stop leaking
float dust, and its semantics gain increase/decrease actions.BeuiAttachmentUpload: cancelling or removing a row mid-transfer no
longer flips it to "Upload complete" when the simulated timer fires.BeuiContextMenu no longer throws from num.clamp on viewports
narrower than the panel; its remeasure loop is capped.BeuiPopover's hover-close delay is cancelled on re-hover and dispose.BeuiPreviewRail's two-tap touch preview no longer resets itself on an
unrelated rebuild.BeuiPromptInput re-measures when maxRows changes.BeuiShaderBackground discards a program that finished loading after
the variant changed, and disposes superseded shaders and the noise codec.BeuiAnimatedSidebar honours a custom width in the offcanvas box;
two AnimatedOpacity wrappers that could never animate are gone.BeuiExpandingArrowButton no longer allocates a CurvedAnimation per
frame per chevron or wraps its reveal in a dead TweenAnimationBuilder.ScrollController per overlay rebuild.BeuiTextCascade, stateful button, action swap, loading
states) animates grapheme clusters instead of UTF-16 code units.BeuiFocusRing, so focusing no
longer shifts layout and the ring meets 3:1 contrast.BeuiColors.resolve(context); beuiSpringSnap and beuiSpringScroll
motion tokens.BeuiAiSidebar.onRenameError, BeuiFeedbackWidget.onSubmitError
(errors were previously swallowed); BeuiMultiChainSwap.networkFee,
slippage, eta (previously hardcoded literals).BeuiAgentIcons.externalLink now reaches the citation and attachment
link glyphs.BeuiMagnetic and BeuiParallax.lerpDouble,
listEquals, num.clamp, Curves.* and math.pi replace hand-rolled
equivalents; every blur routes through beuiBlurSigma.test/support.dart owns the themed test app, blur probe, frame pump
and contrast math; ~110 tautological or build-only tests are deleted
and the shader tests now assert the shader's own paint.core_demos.dart is split per catalog slug
(which fixes the Code tab's source paths), with one shared replay
button, section label and pressable control..pubignore excludes the example's platform folders and fonts.motionFor (95 call sites);
the bare MediaQuery.disableAnimationsOf reads that remain gate
non-motion decisions (whether to mount a transform, blur or ticker).
BeuiAgentDisclosureInternal.reduce is optional and defaults to the
ambient value.?? in copyWith, a field missing from ==, or a
swapped pair in lerp.beuiTestApp instead of a
private copy of the themed MaterialApp.Published: https://pub.dev/packages/beui/versions/2.0.0
BeuiToolApproval/BeuiToolResult tool/title/description/meta narrowed from Object to typed String? + Widget? pairs (deprecated *Node params still accep…
UX-audit remediation across the chat/agent family — 154 audited findings resolved. Almost all API is additive; the deliberate default changes are listed under Changed defaults.
BeuiToolApproval: details open by default whenever parameters exist; a severity tier (normal/elevated/destructive) that re-weights the actions for irreversible commands; expired/timedOut statuses; grant records once-vs-always and an onRevoke affordance; the action row can no longer double-fire during its exit.BeuiStreamingResponse: error is now visibly failed (destructive notice + retry) instead of pixel-identical to complete; new stopped status with a Continue affordance.BeuiAgentActivity: failed/cancelled statuses — a crashed run no longer summarizes as success.BeuiImageGeneration: determinate progress hairline and onCancel.+ menu and model picker, BeuiFileUpload, the feedback widget, and sidebar rows.BeuiOverlay surfaces even with trapFocus: false.focusRing color role (≥3:1 in all 22 theme×brightness combos).BeuiPromptInput: attachment chip rail, keyboard-driven model picker, viewport-aware menu placement, Enter-while-streaming feedback.progress, cancel-in-flight, maxFileSize + inline rejection, seekable audio scrubber.BeuiInput: left-aligned announced errors, label association, shake replay via errorNonce.BeuiFeedbackWidget: drafts survive dismissal, submit validates inline, optional sentiment row.BeuiFileDiff: wrap or horizontal scroll, hunk-gap markers, change navigation.BeuiMessageScroller.builder — lazy sliver path for long transcripts.BeuiPreviewRail works on touch. BeuiChatApp is responsive.BeuiMessage/BeuiMessageBubble animateIn now default to true (mount-only).BeuiToolApproval.defaultOpen resolves by parameters.isNotEmpty.BeuiPreviewRail.highlightActive defaults to true.BeuiFileUpload drag wording is opt-in (dragAndDrop).BeuiToolApproval/BeuiToolResult tool/title/description/meta narrowed from Object to typed String? + Widget? pairs (deprecated *Node params still accepted).BeuiAgentStrings covers the full agent family.BeuiColors.focusRing role (WCAG 2.2 SC 1.4.11).BeuiAgentTheme.statusLight/statusDark.LucideIcons.history removed in flutter_lucide 1.31.0 — replaced with rotate_ccw_clock.BeuiPullToRefresh indicator now follows the finger during the pull.Package: https://pub.dev/packages/beui/versions/1.2.0 Gallery: https://codenameakshay.github.io/beui/
UX-audit remediation across the chat/agent family — 154 audited findings resolved (docs/UX_AUDIT_AGENT_CHAT_FLOWS.md holds the audit). Almost all API is additive; the deliberate default changes are listed under "Changed defaults" below.
BeuiToolApproval: details open by default whenever parameters exist; a
severity tier (normal/elevated/destructive) that re-weights the
actions for irreversible commands (warning glyph, tinted border, Deny
promoted, Always-allow suppressed); expired/timedOut statuses; grant
records once-vs-always and an onRevoke affordance for standing grants;
the action row can no longer double-fire during its exit.BeuiStreamingResponse: error is now visibly failed (destructive notice
complete; new stopped status with
a Continue affordance.BeuiAgentActivity: failed/cancelled statuses — a crashed run no longer
summarizes as success.BeuiImageGeneration: determinate progress hairline and onCancel.+ menu and model picker,
BeuiFileUpload (dropzone/remove/retry), the feedback widget's trigger and
close, and sidebar rows (visible focus + selected ≠ hover).BeuiOverlay surfaces even with trapFocus: false.announceText/onAnnounce hooks) instead
of 3–5 nested regions announcing nothing; terminal outcomes (Failed, Denied,
Copied, Sent) are announced.focusRing color role
(≥3:1 in all 22 theme×brightness combos) — focusing no longer shifts
content.outline bubbles get a visible edge; danger bubbles gain a leading glyph
and AA text.BeuiPromptInput: attachment chip rail (attachments, onAttachmentRemoved,
onAttachmentRetry, onSubmitFull with BeuiPromptSubmission), one
keyboard-driven model picker (BeuiSelectOption.icon), viewport-aware menu
placement, Enter-while-streaming feedback (onSubmitBlocked), memoised
measurement for large pastes.progress on attachment items, cancel-in-flight
(onCancel) distinct from remove, maxFileSize + inline rejection notice,
seekable audio scrubber (onSeek), honest default dropzone copy.BeuiInput: left-aligned error text (was centered — golden-verified),
announced errors, label association, shake replay via errorNonce, and the
standard TextField pass-throughs (autofill, input action, formatters,
maxLength, readOnly…).BeuiFeedbackWidget: drafts survive dismissal, submit validates inline
instead of disabling, optional sentiment row (showSentiment), announced
and screen-reader-stable success state.BeuiFileDiff: wide lines are horizontally scrollable or wrapped
(wrap: adaptive by default) instead of ellipsised; header copy control;
hunk-gap markers with optional context expansion (onExpandContext) and
change navigation; unified-diff copyText default.BeuiMessageScroller.builder — lazy sliver path for long transcripts.BeuiPreviewRail works on touch (tap-to-preview, tap-again-to-commit) and
marks the active destination by default.BeuiChatApp: responsive sidebarBreakpoint, keyboard-inset avoidance,
bubble width clamped (no more debug assert below 44px).BeuiMessage/BeuiMessageBubble animateIn now default to true
(mount-only; streaming updates never replay).BeuiToolApproval.defaultOpen resolves by parameters.isNotEmpty.BeuiPreviewRail.highlightActive defaults to true.BeuiFileUpload copy: "Browse files" / drag wording is opt-in
(dragAndDrop) because OS drop needs a consumer plugin.BeuiToolApproval/BeuiToolResult tool/title/description/meta
narrowed from Object to typed String? + Widget? pairs
(filename/file likewise on code block and diff, with deprecated
*Node params still accepted).BeuiAgentStrings now covers the full agent family (approval, results,
activity, todos, streaming actions, jump-to-latest); resolution is
widget param → theme strings → defaults.BeuiColors.focusRing role — clears WCAG 2.2 SC 1.4.11 (3:1) on all
11 themes in both brightnesses; ring is unchanged and stays for hairline
borders. Amber and lime cannot clear 3:1 in light mode at any alpha, so
their focus hue is darkened to 60% oklch lightness.BeuiAgentTheme.statusLight/statusDark (BeuiAgentStatusColors,
BeuiAgentStatusPalette) — agent status color was previously ~50 hardcoded
literals and could not be rethemed; painted defaults are preserved except
the AA lift noted under Contrast.LucideIcons.history was removed in
flutter_lucide 1.31.0. Replaced with rotate_ccw_clock.BeuiPullToRefresh: the indicator did not track the finger during the pull
(frozen at rest until release) — for all users, not only reduced motion.disableAnimations instead of freezing mid-transition.@@);
one shared disclosure primitive replaces eight, with a reduced-motion branch
that keeps an opacity fade instead of hard-cutting.Semantic theming for the AI-agent family, plus compact-to-expanded approval cards. Default visuals and motion are unchanged: omit BeuiAgentTheme and e
Semantic theming for the AI-agent family, plus compact-to-expanded approval cards. Default visuals and motion are unchanged: omit BeuiAgentTheme and every agent widget still resolves to the 1.0.0 source-fidelity look.
BeuiAgentTheme ThemeExtension — typography roles, bubble/card radii, conversation spacing, density, borders, optional glass cards, and semantic icon slots. Install it next to BeuiColors; ThemeData.fontFamily still owns the typeface.expanded / defaultExpanded / onExpandedChanged, compactChild / expandedChild, headerAction. Existing call sites are unchanged. Height uses beuiSpringLayout and is interruptible; reduced motion snaps.BeuiChatApp.borderRadius and BeuiMessageBubbleContent.maxWidthFactor are now nullable so the theme can supply the default; omitted arguments still resolve to 16 and 0.82.Package: https://pub.dev/packages/beui/versions/1.1.0
Initial release — a one-to-one Flutter port of beUI v2, built on the `motor` motion engine so the source's exact spring physics carry over. All 72 beu
Initial release — a one-to-one Flutter port of beUI v2, built on the
motor motion engine so the source's exact spring physics
carry over. All 72 beui.dev catalog entries across three groups.
📦 pub.dev/packages/beui · 🎨 Live gallery
dependencies:
beui: ^1.0.0
A beui.dev page is not always one component: several pages ship multiple independently-installable widgets, and all of them are covered here.
Tilt Card, Button (+ Stateful + Magnetic), Animated CTA Buttons (expanding / hold / slide), Marquee, Tabs, Switch, Input, Select (+ Morph), Checkbox, Radio Group, Bottom Sheet, Pull to Refresh, Shared Layout Background, Bounce Sidebar, Animated Sidebar (sidebar / floating / inset), Preview Rail, Dock (+ separator-grouped actions), Tooltip, Context Menu, Popover (+ Morph), Morphing Modal, Center Morph Modal, Text Animation (reveal / shimmer / cascade / chromatic), Number Animation (count-up + ticker), Animated Badge, Action Swap (blur / roll / cascade), Animated Toast Stack, Theme Toggle (rectangle / circle / circle-blur / blinds), Bouncy Accordion, Drawer, Scroll Animation (smooth scroll / progress / reveal / scroll-to / parallax), Range Slider (ticked / fluid / wave / bubble / ruler), Wheel Picker, Table, Shader Background (21 GPU variants), Cylinder Carousel, Loader (17 variants).
Infinite Masonry, Notification Stack, Fixtures (knockout bracket with third-place playoff + knockout wheel), Availability Scheduler, Multi-chain Swap, Dynamic Island, Command Palette, Expandable Action Bar, Overflow Actions, Expandable Tabs, Swipeable List, File Upload (upload queue
Message Bubble, Message, Message Scroller, Prompt Input, Todo List, Code Block, Approval Card, File Diff, Tool Result, Streaming Response, Image Generation, Tool Approval, Citations, Agent Activity, Agent Loading States (thinking shimmer / agent progress / reasoning text), AI Sidebar, Chat App.
ease.ts, resolved
through a single motor-backed facade.BeuiColors ThemeExtension with light/dark and 11 color themes.BeuiOverlay foundation for every floating surface (tooltip, drawer,
sheet, modal, command palette).motionFor) that drops movement while preserving
opacity/color feedback.flutter_lucide icon set re-exported through the barrel.BeuiFileUpload and BeuiAttachmentUpload
carry file metadata and expose onBrowse, so the package takes no
file-picker dependency.Tabs/TabsList/TabsTrigger, Select/
SelectTrigger/…, the AnimatedSidebar* family) collapse into single
widgets taking item models, per the Flutter conventions in
docs/PORTING_SPEC.md §6.