neptune_flutter_ui 2.7.0

Neptune Odyssey Flutter UI — the vendor-neutral, white-label banking design system by Neptune.Fintech. Deterministic brandprints, Material 3 themes, and themed widgets for the four reference brands an [...]

Changelog

2.7.0

All nine published templates, composed. lib/src/templates/ ships the full templates.html set as data-parameterised screen widgets (joining NeptuneWelcome): NeptuneAuthTemplate (credentials → OTP), NeptuneKycTemplate (capture tiles + tier limit), NeptuneDashboardTemplate, NeptuneCardsTemplate (swipeable carousel + controls), NeptuneTransferTemplate (amount → review → hourglass/success outcome), NeptuneWalletTemplate and NeptuneCorporateTemplate (responsive side-nav workspace). Hand them data + callbacks; they wear the active brand — any brandprint, LTR/RTL, light/dark. The example gallery gains a template browser and the SHOTS harness captures every template.

2.6.1

• Colour canon: brand tables are now GENERATED from themes.css via the repo's token codegen (single OKLCH implementation shared with the web). 21 of 296 role values shift by ±1 LSB — imperceptible — making pinned brands and custom-seed generation exactly consistent.
• Fix: NeptuneSegmented no longer fails layout (silently blanking the subtree) in unbounded-width slots such as NeptuneListTile.trailing — it shrink-wraps when unbounded, keeps equal-width segments when bounded.
• NeptuneWelcome gains lockup: for real client logos.
• pub.dev screenshots added.

2.6.0

Templates & motion — the living Odyssey vibes. The Welcome / Sign-in template and the animated flourishes from templates.html, ported for real (engine-rendered screenshots verified per brand), plus a new Odyssey-original outcome motion:

• NeptuneStatusMotion — an animated HOURGLASS (draining sand + flip loop) that hands off smoothly to an animated SUCCESS check (stroke-drawn, colour- able, defaults to the brand success role) or an animated REJECTED cross (stroke-drawn with a decaying shake). The three states are linked through a spin-out/spring-in transition on the brand motion curves.
• NeptuneCta is now the real premium CTA: a slow SPECULAR SHEEN sweeps the pill on the web's 4.8s cycle, the arrow NUDGES (±4dp / 2.4s, mirrors under RTL), press scales to 0.98 on the emphasized curve, and the primary key-light glow rides underneath. New tonal: secondary tone. All motion pauses under reduced-motion.
• NeptuneWelcome + NeptuneAmbientBackdrop + NeptuneBrandLockup — the full Welcome / Sign-in template: radial brand wash, three soft orbs drifting on 15/19/17s loops (static under reduced-motion), the brand lockup with its accent dot, and the bold mixed-weight promise (display-w500 + w800 primary).
• Example: "Motion & templates" gallery section + a push-able Welcome route; the SHOTS harness now captures pushed routes (boundary moved to MaterialApp.builder) and renders the Welcome per brand.

2.5.2

Two real layout bugs caught by the full-depth visual sweep (every gallery viewport × 4 brands × light/dark):

• NeptuneToolbar now hands its center slot BOUNDED width (children wrapped in Flexible). A flex child there (e.g. NeptuneSearchField, which contains an Expanded) previously failed layout and blanked the surrounding subtree. Regression-tested with a SearchField in the center slot.
• NeptuneCreditScoreGauge honours its size under tight constraints (e.g. inside Expanded) instead of painting a giant arc outside its bounds.

2.5.1

Depth polish: NeptuneCta now rides elevation-3 with a soft primary key-light (the web CTA recipe) instead of sitting flat, and showNeptuneDialog gets the deep soft drop (web elevation-5). Verified via the SHOTS harness.

2.5.0

The identity release — Odyssey stops looking like generic Material. Ports the web token levers that sit above the M3 colour scheme, so every brand carries its signature look (verified pixel-by-pixel against the shipped web templates via engine-rendered screenshots across 4 brands × light/dark × RTL):

• NptIdentity theme extension: per-brand glass recipes (--npt-glass-tint mix ratios + blur), the signature motif lever, elevation tokens (--npt-elevation-1/2/3/5), the primary key-light glow, and the login-shell / dashboard-hero / content-tone levers. Resolves for custom brandprint seeds too (keyed off the glassTint lever).
• NeptuneMotifLayer: the four brand motifs as CustomPainters — Neptune sonar tide-rings, Triton coastal arcs, Nereid grid-spark, Proteus shield guilloché — ported from the --npt-motif CSS gradients.
• NeptuneGlass: real backdrop-blur glass with the brand tint and hairline seal (card glass + dock pane recipes). NeptuneCard with the web's four variants (standard / elevated / tonal / glass, motif: overlay opt-in).
• NeptuneEyebrow: the uppercase, letter-spaced display-face micro-label.
• Widgets now wear the identity: the dock is glass with the raised-active circle popping above the bar (sprung on the brand motion curve), card art carries the motif + elevation + selection glow, the balance-card hero etches the motif over its gradient with the web's display-md amount, onboarding heroes get the login-shell motif backdrop, stat cards use the eyebrow.
• Example gallery: fixed phone-frame window on macOS, content scrolls under the glass dock, and a --dart-define=SHOTS=true harness renders pixel-exact gallery screenshots per brand/mode/scroll for visual regression.

2.4.0

The "fully fledged" release — ~33 new branded widgets take the package past Material parity into a complete fintech design system (now ~88 widgets). All theme-only (no literal colours/radii/fonts), RTL-safe, ≥48dp; 40 widget tests pass under light/dark/RTL × brands; flutter analyze clean.

• Form fields: NeptuneTextField, NeptuneSelect, NeptuneStepperInput, NeptuneDateField.
• Selection controls: NeptuneCheckbox/NeptuneCheckboxTile, NeptuneRadioGroup, NeptuneSwitch, NeptuneSegmented, NeptuneSlider.
• Overlays: showNeptuneDialog, showNeptuneSheet, NeptuneMenu, NeptuneTooltip.
• Navigation / structure: NeptuneTabs, NeptuneBreadcrumbs, NeptunePagination, NeptuneAccordion.
• Display: NeptuneAvatar/NeptuneAvatarGroup, NeptuneBadge, NeptuneTag, NeptuneProgressBar, NeptuneProgressRing, NeptuneRating, NeptuneListTile, NeptuneTimeline.
• Fintech: NeptuneInsightCard, NeptuneFxCard, NeptuneBudgetRing, NeptuneSpendBreakdown, NeptuneCreditScoreGauge.

Mobile-readiness fixes (found by narrow-width testing): NeptuneAccountTile and NeptuneLimitMeter trailing values now flex/ellipsize; NeptuneApprovalItem stacks its actions on narrow widths; NeptuneTabs no longer requires a bounded height. The example app gained gallery sections for every new widget.

2.3.0

The full solution — real brand typography + the remaining structural widgets.

• Fonts now render for real. NeptuneTheme integrates google_fonts: each brand's display / text / num families (Hanken Grotesk, Bricolage Grotesque, Space Grotesk, Sora) are loaded and applied to the whole TextTheme, and moneyStyle resolves the brand num face with tabular figures.
• Arabic / RTL faces. NptType now carries the Arabic faces per brand (displayAr / textAr / numAr — IBM Plex Sans Arabic, Reem Kufi, Tajawal, Readex Pro, Noto Kufi Arabic, matching the web --npt-font-*-ar tokens). Pass arabic: true to NeptuneTheme.light/dark/fromConfig/fromBrandprint for an RTL build; moneyStyle is direction-aware and swaps to the Arabic numeral face under RTL, mirroring the web's [dir="rtl"] font swap.
• New widgets: NeptuneDataTable (themed Material DataTable, zebra rows, numeric/money columns), the responsive shell — NeptuneAppShell, NeptuneSideNav / NeptuneSideNavItem, NeptuneToolbar, NeptuneNavRail (Material NavigationRail) — plus NeptuneCardControls, NeptuneAddCard (dashed tile), and NeptuneToast + showNeptuneToast (overlay, no Scaffold needed).
• Example: a full components-gallery screen showcasing every widget.
• Colour goldens unchanged (byte-identical); flutter analyze clean; all widget tests pass under light / dark / RTL × 4 brands. COVERAGE.md updated.

2.2.0

Widget parity, round 2 — the package now ships ~46 branded widgets (up from 16), covering the full dashboard / transfer / corporate / wallet surfaces:

• Money inputs: NeptuneAmountInput, NeptuneCurrencyField, NeptuneIbanField, NeptuneOtpInput, NeptunePinInput, NeptuneAmountKeypad.
• Money movement: NeptuneStepper, NeptuneTransferReview, NeptuneMethodRow, NeptuneBeneficiaryTile, NeptuneSuccess, NeptuneReceipt.
• Data-viz (CustomPainter): NeptuneSparkline, NeptuneDonut, NeptuneLimitMeter, NeptuneTrend.
• Corporate: NeptuneApprovalItem, NeptuneBatchCard, NeptuneAuditRow, NeptuneUserRow, NeptunePermissionToggle, NeptuneWorkflowStatus.
• Wallet/pay: NeptuneMerchantRow, NeptuneVoucherCard, NeptuneQrPay, NeptuneTopupRow, NeptuneTierBadge.
• Feedback/shell: NeptuneAlert, NeptuneBanner, NeptuneEmptyState, NeptuneSkeleton, NeptunePageHeader, NeptuneSearchField.

All theme-only (no literals), RTL-safe, ≥48dp; 36 widget tests pass under light/dark/RTL × 4 brands; flutter analyze clean. COVERAGE.md updated.

2.1.0

Widget parity pass — the package now ships 16 branded widgets (up from 4), matching the web components shown in the docs templates. New:

• NeptuneButton (filled / tonal / outlined / text) + NeptuneCta (animated pill CTA), NeptuneStatCard, NeptuneCardArt (gradient card + selected ring), NeptuneQuickActions / NeptuneQuickAction, NeptuneDock / NeptuneDockItem (floating nav, raised active indicator), NeptuneAppBar, NeptuneOnboarding, NeptuneSection, NeptuneChip, NeptuneStatusChip.
• A real example app (example/) — a themed dashboard + onboarding screen built only from the widget set.
• Honest COVERAGE.md mapping every web component → implemented / Material fallback / TODO (nothing silently dropped).
• All widgets theme-only (no literals), RTL-safe, ≥48dp targets; test/widgets_test.dart builds them under light/dark/RTL × 4 brands. flutter analyze clean.

2.0.0

Aligns the Flutter package with the Neptune Odyssey 2.x line (vendor-neutral, white-label).

• Reference brands are the four neutral demo skins — neptune / triton / nereid / proteus (no real-institution identity).
• Brandprint strings remain byte-identical to the JS/TS reference and stable across versions: a saved NO1-… resolves to the same theme on Flutter, Web, React, Vue, Svelte and React Native (golden-tested).
• NeptuneTheme.light / .dark / .fromBrandprint / .fromConfig; ThemeExtensions NptColors / NptShape / NptType / NptMotion; theme-only widgets (balance card, transaction row, account tile, primary button). RTL-safe, ≥48dp targets, no literals.
• 31 golden tests; flutter analyze clean.

1.0.0

First stable release of the Neptune Odyssey Flutter package by Neptune.Fintech.

• Const M3 ColorSchemes for the four reference brands × light/dark, byte-identical to the cross-platform pinned palettes (build/tokens.resolved.json).
• ThemeExtensions: NptColors (incl. success roles), NptShape, NptType, NptMotion.
• NeptuneTheme.light / .dark / .fromBrandprint / .fromConfig → full ThemeData(useMaterial3: true); money uses FontFeature.tabularFigures().
• Brandprint codec (byte-identical to the JS reference, idempotent, checksum-validated) and the shared OKLCH→sRGB converter for custom seeds.
• Theme-only widgets (balance card, transaction row, account tile, primary button); EdgeInsetsDirectional + ≥48dp targets; no literal colours/radii/fonts.
• 31 golden tests; flutter analyze clean.