Repository navigation
v3.0.0 — Charts family and the v3 catalog
beUI 3.0.0 integrates the remaining v3 catalog families into one package:
motion components, blocks, agents, and charts.
Compatibility changes
- Prediction Market odds callbacks now report
side: "yes"for every row, including rows displaying No, matching the source preview. The callback signature is unchanged. - Feedback rejects empty or whitespace-only submissions. Closing discards the draft and selected sentiment; a rejected submission keeps the draft for retry.
BeuiTextThemedefaults now name Geist and Geist Mono. Consumers must provide those fonts; the package still bundles no font assets.- The minimum Flutter version is now 3.44.2 (was 3.44.0).
Components
- Port Timeline, Animated Alert, Collapsible, Aspect Ratio, Arc Picker, Sortable List, Image Viewer, Date Range Picker, Card, Color Picker, Color Selector, Breadcrumb, Expandable Control, Adaptive Stepper, Combobox, Multi Select and File Tree.
- Add
BeuiMetallicButton,BeuiTextScramble,BeuiDigitSwapandBeuiInlineSlider. - Tabs gain optional icons (
always/selected) plus overflow chevrons; tooltip gains arrow, align, disabled,BeuiTooltipProvider,followCursorand collision-aware flip. - Color Selector selection ring hugs the active swatch in the swatch color; Adaptive Stepper rest actions paint circular surfaces and hover with muted; Digit Swap gallery Animate control is compact under the digits.
- Input gains
reserveErrorLineso validation does not shift nearby content. - Table gallery adds editable and async bands (
onCellEdit,onEndReached). - Reorder the motion gallery to match beui.dev (New first, then All).
- Table gains opt-in intrinsic sizing (
BeuiTableSizing,BeuiTableIntrinsicSample). It also keeps collapsed grid geometry, menus, native keyboard input and the initial drag displacement. - Tooltip supports controlled external anchors and keeps focus and dismissal correct when assistive technology activates it.
- Availability Scheduler's copy menu works from the keyboard: arrow keys move, Space toggles a day, and a disabled Apply never activates the schedule behind it.
- Range sliders match the source's pointer and keyboard input, and disabled wave and bubble sliders ignore drags.
- Number Ticker measures source digit slots and text baselines. Checkbox wraps long labels within the available width.
- Fix stale component lifecycle and gesture-release state, reduced-motion geometry, Alert exit continuity, Card gallery control names, Number gallery overflow, and Image Viewer demo opening.
Blocks
- Project Folder (
BeuiProjectFolder) — file fan on hover/focus that morphs into a focus-managed overlay grid; folder rotateX springs with the fan. - Card Folder (
BeuiCardFolder) — landscape card in a stitched purse pocket, with DigitSwap details and an optional overflow action. - Morphing Search (
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 slugmorphing-search-chipsisolates Chip Search. - Morphing Tabs (
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. - Sign Up Form (
BeuiSignUpForm) — composed registration with punish-late field errors, strength meter, and a stateful submit. - Prediction Market cards (
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 slugprediction-market-cardisolates the listing. - Gallery order now matches beui.dev/components/blocks (Fixtures title; File Upload and Prediction Market stack their install targets).
Agents
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 asizeoverride
(defaultw-64/ 256; the live preview usessm:w-72/ 288).- Approval Card and its Input fields match the source's badge, counter and placeholder styles. File Diff keeps single-line diffs on narrow views.
- Gallery order now matches the source agents page clusters, then extras
(AI Sidebar, Chat App, Voice Orb, Agent Theme).
Charts
- Chart tooltip numeric labels use
BeuiChartTickerfor 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 JSMath.round.BeuiPriceTargetFan— high/mean/low target fan over a history path.
Known issues
- Combobox can lose the first characters typed into its search field on Flutter web. The cause is in the Flutter engine: it attaches text-editing listeners after the first input arrives. No safe fix is available yet.
Install: flutter pub add beui · pub.dev · Live gallery