NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev
A themeable Flutter UI component library for mobile banking and fintech apps. RTL-aware, privacy-aware, accessible widgets that compose into any host app.
Latest stable
0.3.0
Last release 2 months ago
31 Aug 2026
Ships fairly regularly
a new release about every 4 weeks
Nearly every release is documented
notes for 6 of 6 stable releases
Nothing withdrawn
no release was ever pulled
4 months old
6 releases · first in 2026
Drag across the ruler to compare, or tap a release to open it.
Stability and support policy (doc/enterprise/stability-and-support.md): the dependency contract. What counts as a breaking change for a UI kit, includ…
Four themes: the trust artifacts an enterprise intake process asks for, the token architecture finished end to end, a branded motion system, and the remaining audit backlog cleared.
BankSkeletonVariant gained four values. listTile, card,
balanceHero, and chart were appended to the four the enum shipped with
in 0.2.0. Dart 3 checks switch exhaustiveness, so a switch over the enum
written against 0.2.0 with no default or wildcard arm stops compiling on
upgrade (non_exhaustive_switch_expression). Adding a wildcard arm is the
whole migration:
// Before: compiles against 0.2.0, fails against 0.3.0.
final caption = switch (variant) {
BankSkeletonVariant.accountCard => 'Loading account',
BankSkeletonVariant.transactionTile => 'Loading transactions',
BankSkeletonVariant.potCard => 'Loading pots',
BankSkeletonVariant.generic => 'Loading',
};
// After: compiles against both.
final caption = switch (variant) {
BankSkeletonVariant.accountCard => 'Loading account',
BankSkeletonVariant.transactionTile => 'Loading transactions',
BankSkeletonVariant.potCard => 'Loading pots',
_ => 'Loading',
};
The original four keep their names and their declaration order, so a
persisted index or name still resolves to the same variant. The full list
and its order are pinned by test/async_states_test.dart, so a further
addition cannot ship without another entry under this heading.
doc/enterprise/acr/ACR.md): a
per-component WCAG 2.1 A and AA plus EN 301 549 V3.2.1 report, with a
machine-readable OpenACR source of truth beside it
(doc/enterprise/acr/openacr.yaml, GSA catalog
2.4-edition-wcag-2.1-508-eu-en). It is a self-assessment, states so on its
first page, and names the areas where evidence does not exist.doc/enterprise/stability-and-support.md): the dependency contract. What
counts as a breaking change for a UI kit, including the case that actually
bites here: a default colour, size, elevation, font, or motion value
moving without an analyzer warning. The deprecation window with a 90-day
wall-clock floor, a procedure for retiring a visual default, pinning
guidance, the supported-version policy, the 1.0 gate as an 11-point
checklist with the current status of each criterion, and the continuity
story for a single-maintainer project..github/workflows/sbom.yml); pub.dev publication over OIDC with no
stored credential, bound to a tag ref (.github/workflows/publish.yml);
Sigstore-backed SLSA build provenance attached to release artifacts
(.github/workflows/release.yml); and a weekly OpenSSF Scorecard run
(.github/workflows/scorecard.yml). Every third-party GitHub Action is
pinned by commit SHA. Documented in doc/enterprise/supply-chain.md.README restructured for two readers. The top third now answers what a bank or agency evaluator asks at intake, as a question-and-evidence table covering the ACR, the CI-enforced accessibility gates, the compliance split, the SBOM and provenance chain, the published Scorecard, and the stability contract, each linked to the document that carries the proof. The component catalogue, screenshots, and quick start are unchanged in substance. Counts corrected to 173 exported widget classes and 487 test cases, and the badges row gains Scorecard and pub.dev.
doc/enterprise/versioning-and-releases.md now describes the release
pipeline as implemented rather than as planned, and corrects the Flutter
floor to 3.44.0 with CI on 3.44.4. Cross-links the new stability policy
rather than restating it. The roadmap milestones are re-dated against what
each release actually contained, and the four journey controllers that did
not land in this one move to v0.4.0 rather than staying pointed at a
version that has shipped.
Documentation corrected where it lagged the code: injectable image
resolution through BankUiScopeData.imageResolver ships, so the README no
longer lists air-gapped image loading as a roadmap item.
Design-token architecture completed: the DTCG source now carries a
12-rung neutral ramp, surface and ink tiers, border roles, a six-rung
icon-size ladder, an opacity ladder, and an elevation-tier enumeration.
BankThemeData.custom and fromJson read their greys from these tokens
instead of hard-coding them, with no behaviour change. Typography gains a
line-height ladder on every text style and caps-tracking tokens.
Branded sheet presentation (BankSheet, BankDialog): all 31 modal
surfaces in the kit (23 BankSheet.show call sites and 8 BankDialog.show)
now present with the theme's radius, a brand-derived
scrim, a grab handle with semantics, an optional shared header,
keyboard-aware insets, and token motion that collapses under reduced
motion. No stock showModalBottomSheet or showDialog call remains in
lib/.
BankAsyncContent plus skeleton shapes built from the kit's real
anatomy, so loading, error, empty, and content are one switch rather than
a host-assembled pile of grey rectangles.
BankSliverAppBar and app-bar title modes (standard, large,
collapsing), and an opt-in per-step help affordance on
BankStepProgressIndicator for regulated journeys.
Identity system: BankEmblem gains a size ladder, theme-derived tints
that measure their own contrast to clear AA on any hue, an inset ring
slot, and BankEmblemStack with +N overflow.
BankValueDiffRow.previousLabel and BankValueDiffRow.newLabel, and
the same two parameters on BankValueDiffList. Both BankValueDiffStyle
variants now render one grammar, old value then arrow then new value, so
the 'Previous' / 'New' microlabels are gone from the output and passing
a value has no effect. There is no replacement parameter: the old-to-new
relationship is carried by the struck value and the arrow, and what
assistive technology says about the row is localised through
semanticLabel. BankValueDiffList no longer forwards either parameter to
its rows, so the analyzer warning reaches the call site that set it rather
than being swallowed. Both are removed in 0.5.0.
// 0.2.0: two captioned lines, 'Précédent 5 000,00 €' / 'Nouveau 8 000,00 €'.
BankValueDiffRow(
label: 'Limite',
oldMoney: previous,
newMoney: next,
style: BankValueDiffStyle.stacked,
previousLabel: 'Précédent',
newLabel: 'Nouveau',
)
// 0.3.0: '5 000,00 € → 8 000,00 €', the old value struck through.
BankValueDiffRow(
label: 'Limite',
oldMoney: previous,
newMoney: next,
style: BankValueDiffStyle.stacked,
semanticLabel: 'Limite passe de 5 000,00 € à 8 000,00 €',
)
BankConsentModal and BankDisclosureConsentSheet, and every tappable
emblem inside BankEmblemStack); the IBAN copy affordance confirms
visually and announces to assistive technology; OTP cells encode focus with
one signal instead of swapping both fill and border; picker values are
typographically distinct from placeholders; the insight card's confidence
dots are labelled instead of reading as broken pagination.BankSheetHandle; the sliders in BankCardControlsPanel,
BankCreditLimitAdjuster and BankTransferLimitManager sat inside
excludeSemantics: true, which deleted the framework's slider node
together with its role, its value and its increase and decrease actions, so
the limit could not be changed by assistive technology at all, and now
merge their heading into that node instead of replacing it; a consent
checkbox the user cannot tick yet paints its outline at the disabled
opacity again rather than at full strength; and BankSliverAppBar in its
collapsing mode no longer leaves an unnamed heading with an empty
namesRoute beside the large title. The sliders in
BankLoanCalculatorCard and BankSavingsProjectionCard still exclude
their node; that is item 19 on the ACR roadmap.BankMoneyFormatter.format(currencyCode: 'BHD', ...)
rendered د.ب1,234.567, a stray leading space and the marker glued to the
first digit, instead of د.ب 1,234.567. The gap now sits outside the
isolate on the digits' side, which is where it holds its place in an
English paragraph and an Arabic one alike. splitMajorMinor carries the
corrected atom too.BankPrizeDrawCard formatted prizeAmount and its semantic summary
with the ambient Intl.defaultLocale rather than the app locale, so a
de-DE app rendered USD 500,000 and a German reader parsed it as five
hundred. Both now resolve context.bankLocale, matching every other money
surface in the kit.Spacer for the action row's slack and ellipsized
to "High confid…" on a 360 pt phone, defeating the point of replacing the
dots with words; and the horizontal account card's back face, whose height
is fixed by the card aspect ratio, overflowed once an account carried both
an IBAN and a sort code on a narrow device or at a raised text scale. The
meter now takes the whole slack, and the back face degrades by scrolling
rather than by clipping.Card.elevation sentinel or on a direct
BankTokens.shadow* call, so two resting cards on one screen no longer
drop differently coloured shadows; Studio dark's primary CTA no longer
reads as disabled; and BankThemeData.gradientReach is now read at the
twelve surfaces that used to paint the accent gradient raw, so under
Voltage the violet-to-cyan sweep stays full strength on hero card faces and
drops to the same hues at a rationed alpha on supporting headers, promo
strips and icon rings. BankHorizontalAccountCard's theme-gradient face
still reads the gradient directly; it is a hero surface, the tier
gradientReach never rations, so it renders identically either way.
test/policy_adoption_test.dart asserts both policies on the painted
decorations of a rendered tree rather than on the theme methods, so a call
site that drops back to theme.accentGradient or BankTokens.shadow* raw
fails CI.Your coding agent can read these notes before it upgrades. Set up the MCP server →
One column per month.
A premium-quality overhaul driven by a full visual and code audit against Backbase-class design systems: 7 systemic themes, 76 ranked defects, the top
A premium-quality overhaul driven by a full visual and code audit against Backbase-class design systems: 7 systemic themes, 76 ranked defects, the top 24 fixed in this release.
BankPressable wrapper gives cards,
tiles, keypads, and quick actions pressed-scale, hover/focus state layers,
a keyboard focus ring, and button semantics; state-layer opacities and
press scale are theme tokens.Brightness
resolvers plus hairline edge tokens, adopted across 30+ card surfaces
through one internal resolver; Material Card elevations migrated to the
token language.displayFontFamily (Heritage gets a bundled
Noto Serif Display face, Bloom uses Fredoka), cardSurfaceGradient, and
generative BankCardPattern overlays (mesh, lattice, arcs, grid), all
serialised in theme JSON.markBuilder escape hatch for licensed artwork; shared metallic
BankCardChip and a single PAN treatment across all card widgets.BankSegmentedControl: theme-driven segmented control (no M3
checkmark, 44 px minimum, labels never fracture mid-word).BankCountryFlag: tofu-proof country indicator (crafted ISO chip by
default, emoji opt-in, global flagBuilder override on BankUiScope).trimZeroCents, splitMajorMinor, deliberate
unknown-code fallback; balance count-up animation; amounts scale down
instead of ellipsizing.ButtonStyle.textStyle).BankAccountCard: dead 70-90 px band removed (content-sized), resting
shadow restored in all presets, frozen state desaturates instead of
stamping a snowflake over the balance, status chips use the unified
semantic ramps.annualRate documented and asserted as a fraction
with a formatting helper (no more 890% demo APRs); catalog rates read
"From 5.9% APR" in order.Turns the kit from a widget library into a design system: tokens become platform-neutral data, money formats per locale, and accessibility is enforced
Turns the kit from a widget library into a design system: tokens become platform-neutral data, money formats per locale, and accessibility is enforced in CI.
tokens/design-tokens.json): the
scalar tokens (colours, spacing, radius, motion, tap target) now generate
lib/src/theme/tokens.dart via tool/generate_tokens.dart, with a CI drift
guard (--check). Composite tokens (text styles, curves, shadows) stay
hand-authored and reference the generated values.BankThemeData.toJson() / .fromJson(): any brand (including the four
presets) serialises to/from JSON (#RRGGBBAA hex) for Figma Variables,
native platforms, and server-driven / remote branding. All presets are
exported to tokens/themes/ (regenerate via test/theme_export_test.dart).BankMoneyFormatter.format/formatSign
accept a locale so grouping and separators follow the market (German
1.234.567,89, French 1 234 567,89, Indian lakh 12,34,567.89). Core
money widgets resolve it from Localizations automatically; the new
BuildContext.bankLocale extension exposes it for direct formatter calls.kBankFontFallback): OFL Noto
subsets for currency symbols (₹ ₩ ₫ ₿ Ξ …), Arabic script, Latin-Extended
(ł, č …), and Arabic-Indic / Persian / Devanagari numerals, wired as
fontFamilyFallback on every text style and theme — so every script the kit
advertises renders, even offline / on web without a CDN.doc/enterprise/design-tokens.md documenting the token pipeline.onPrimary (2.78:1 → dark ink), Heritage dark onPrimary (4.44:1), and the
financial semantic colours (positiveBalance 2.26:1, pending 2.03:1,
negativeBalance). Semantic colours are now brightness-aware (AA-compliant
emerald/red/amber on light surfaces, lighter variants on dark), applied
automatically by BankThemeData.custom().alchemist dev dependency — it never compiled against Flutter 3.44 (missing
Canvas methods) and is replaced by Flutter-native golden tests.Adds a product-origination surface and a complete reference app.
Adds a product-origination surface and a complete reference app.
lib/src/products/): BankProductCard
(rate hero, feature list, badges, dual call to action),
BankProductCategoryTile (catalogue grid), BankEligibilityResultCard
(soft-search outcome with a no-credit-impact reassurance),
BankOfferSummaryCard (firm or indicative offer with the regulatory
representative example), BankRatioGauge (LTV / DTI / LTI affordability
bands), BankDisclosureConsentSheet (pre-contract disclosures and
no-dark-pattern consents), and BankESignaturePad (typed or drawn,
timestamped signature). Every visual decision is an optional constructor
parameter defaulting to the active theme.BankApplicationController: a seven-step application state
machine (eligibility, customise, offer, documents, disclosures, sign,
decision) with validity and completion tracking, exported from core.dart.flutter run -t lib/flagship_main.dart.doc/research/banking-products.md.BankEligibilityResultCard's primary action now sets its label colour
explicitly so the call to action stays legible under every preset.Raised the Flutter floor to >=3.44.0 and migrated every deprecated API to its current replacement: Switch activeColor to activeThumbColor, SemanticsSe…
Maintenance release: clears the pub.dev analysis findings for a clean score.
fl_chart to ^1.2.0 and qr to ^4.0.0 (both now on their
latest majors). The QR view adopts the qr 4.x QrPayload API.>=3.44.0 and migrated every deprecated
API to its current replacement: Switch activeColor to
activeThumbColor, SemanticsService.announce to sendAnnouncement,
SizeTransition.axisAlignment to alignment, Matrix4.scale to
scaleByDouble, and DropdownButtonFormField.value to initialValue.No public API changes; widgets render and behave exactly as before.
Initial public release: 140+ composable banking widgets across 22 domains, four built-in design languages, and one theming engine.
Initial public release: 140+ composable banking widgets across 22 domains, four built-in design languages, and one theming engine.
BankThemeData.custom() (only primary and brightness
required) and the ThemeData.withBankTheme() extension.BankBalanceText and every money surface mask through
BankUiScope, verified by a mask-proof test across the render and
semantics trees.NumeralStyle.BankUiStrings localization escape hatch; no gen-l10n dependency.Decimal-backed Money type; no double touches an amount.BankKycFlowController,
BankTransferFlowController, BankIncomeSorterController) that never
touch the network.flutter analyze clean on the package and the example app.example/.