coconut_design_system 0.9.9
coconut_design_system: ^0.9.9 copied to clipboard
The Coconut Design System For Coconut Vault/Wallet. Anyone who wants to use this design system is free to do so.
๐ CHANGELOG #
All notable changes to the Coconut Design System will be documented in this file.
This project follows Semantic Versioning. #
0.9.9 - 2026-01-02 #
โจ Features #
- Pulldown
- Added
isSelectedItemBoldoption to customize font weight when the item is selected. - Added
paddingoption to customize padding.
- Added
0.9.8 - 2026-01-02 #
0.9.7 - 2025-11-12 #
0.9.6 - 2025-10-21 #
โจ Features #
-
Popup
- Added
centerTitleoption to align title text inCoconutPopup. - Added
useFixedFontSizeoption to control font scaling inCoconutPopup.- Added
useFixedFontSizeparameter to maintain consistent text sizing. - When enabled, applies
TextScaler.linear(1.0)to override system font scale. - Defaults to
truefor consistent popup appearance across devices. - Improves accessibility and design consistency.
- Added
- Added
-
Checkbox
- Added
disabledColorproperty for enhanced customization.
- Added
๐ Fixes #
-
AppBar
- Centered title with
subLabeleven whenactionButtonis absent.
- Centered title with
-
SegmentedControl
- Corrected
AnimatedSegmentedControlwidth calculation for proper layout.
- Corrected
-
Tooltip
- Corrected icon padding in fixed tooltip.
-
Popup
- Updated default font sizes in
CoconutPopup(title: 18 bold, description: 18, buttonText: 16 bold).
- Updated default font sizes in
0.9.5 - 2025-09-19 #
๐ Fixes #
- SegmentedControl
- Adjusted position calculation logic for the animated background to ensure the indicator aligns correctly with the selected segment.
0.9.4 - 2025-09-19 #
โจ Features #
-
General
- Added
currentCountfield for enhanced state tracking.
- Added
-
SegmentedControl
- Added option to toggle selection animation.
๐ Fixes #
-
TextField
- Added
enabledproperty for better control over interactivity.
- Added
-
Stepper
- Added
minCountandinitialCountto prevent invalid states.
- Added
-
CoconutPopup
- Updated default button font style for consistency.
-
SegmentedControl
- Synced selection state with parent updates and reset animation to ensure UI consistency.
โป๏ธ Refactor #
- Tooltip
- Removed multiline detection logic using
TextPainterfor simplification.
- Removed multiline detection logic using
0.9.3 - 2025-08-22 #
0.9.2 - 2025-08-07 #
โจ Features #
-
TextField
- Added
autocorrectandenableSuggestionsoptions. - Added
onEditingCompletecallback toCoconutTextField.
- Added
-
AppBar
- Applied
systemOverlayStyletobuildHomeAppbarbased on platform and brightness.
- Applied
0.9.1 - 2025-07-18 #
โจ Features #
-
Colors
- Added
gray750toCoconutColors.
- Added
-
Layout
- Added
spacing_150toCoconutLayout.
- Added
-
AppBar
- Added
customTitleattribute. - Removed
HitTestBehavior.translucentfromGestureDetectoroncustomTitle. - Made
titleattribute optional.
- Added
-
TextField
- Added
fontWeightandborderRadiusattributes. - Added
enableInteractiveSelection.
- Added
-
Tooltip
- Added
borderRadiusattribute.
- Added
-
Switch
- Added support for
trackColorandscale. - Applied minimum size constraints.
- Added support for
-
Animation
- Introduced
CoconutShakeAnimationwidget for reusable shake effects.
- Introduced
๐ Fixes #
-
TextField
- Fixed
onChangednot triggering whencontroller.textchanges. - Prevented multiple listener calls when text is unchanged.
- Fixed
-
Switch
- Ensured minimum size application to
CoconutSwitch.
- Ensured minimum size application to
0.9.0 - 2025-06-17 #
โจ Features #
CoconutColors- Added
warningText,borderGray,borderLightGray,oceanBlue,whiteLilac,searchbarBackground,searchbarHint,searchbarText,cyanBlue,secondaryText,gray850,warningYellow,warningYellowBackground.
- Added
- Styles
- Introduced
CoconutBorder,CoconutPadding,CoconutBoxDecorationutility classes for standardized styling.
- Introduced
CoconutToast- Added support for replacing an existing toast.
๐ Fixes #
- Color
- Fixed typo in color name:
borderLightgrayโborderLightGray.
- Fixed typo in color name:
CoconutTextField- Fixed placeholder text to always initialize regardless of prefix presence.
CoconutAppBar- Fixed platform-specific
systemOverlayStylehandling for accurate status bar icon brightness. - Replaced
nullwith an emptyContainerasflexibleSpacefallback to avoid rendering issues.
- Fixed platform-specific
โป๏ธ Refactor #
- Simplified
home-appbar-iconlayout and padding logic.
0.8.0 - 2025-05-09 #
โ ๏ธ Breaking Changes #
CoconutPulldownMenu- Replaced
buttonsandonTapwithentriesandonSelected. entriesis now required.- Introduced
CoconutPulldownMenuGroupto support grouped items. - Deprecated
buttonsandonTap. Backward compatibility maintained temporarily. - โ ๏ธ Update your implementations to use the new
entriesmodel. - Improved divider and border handling for dynamic structures.
- Replaced
โจ Features #
CoconutToolTip- Added support for optional custom icons.
- Adjusted icon alignment dynamically based on
richTextline count.
CoconutTextField- Placeholder now stays top-aligned and toggles visibility with focus.
- Counter color logic refined and placeholder ignores pointer events.
- Placeholder text height now aligns with input text height.
- Added demo
svgasset forobscureTextmode.
CoconutToast- New method:
showWarningToast()with warning color and icon. - Icon alignment now adjusts based on
richTextline count.
- New method:
๐ Fixes #
CoconutPulldownMenu- Default horizontal padding corrected to
20. - Top border radius now applied correctly when the first item is not a group.
- Default horizontal padding corrected to
CoconutTextField- Placeholder behavior and layout improved as above.
CoconutAppBar/CoconutPopupbuildWithNext'stoolbarHeightadjusted for bottom app bars.- Fixed leading icon padding and popup dialog radius mismatch.
CoconutToast- Fixed iOS dark background issue by setting
MaterialType.transparency.
- Fixed iOS dark background issue by setting
โป๏ธ Refactor #
- Renamed toast icon asset:
circle_info.svgโinfo_circle.svg. - Adjusted icon sizing and alignment within toast components.
0.7.3 - 2025-04-16 #
โจ Features #
- Added
CoconutFrostedAppBar, a newPreferredSizeWidgetvariant with blur background, scroll-based title opacity, and dynamic background color adjustment based on scroll. - Added support for automatic
line-height(height) scaling based on font size viaapplyVariation().- Headings (
โฅ 24px):1.2 - Body text and captions (
< 24px):1.4
- Headings (
โป๏ธ Refactor #
- Unified theming logic by removing
brightnessparameters and usingTheme.of(context).brightnessinternally. - Simplified AppBar button icon rendering using shared asset logic.
- Extracted and renamed internal AppBar builder functions for clarity and modularity:
build()โ general AppBar with optional back/close icon, sublabel, etc.buildHomeAppbar()โ sliver-based AppBar optimized for home layouts.buildWithNext()โ AppBar variant with a trailing "Next" action button.
๐ UI Improvements #
- Consistent spacing, padding, and icon sizing across all AppBar types.
- Added support for
PreferredSize bottomWidgetandEdgeInsets appBarInnerMargininbuildHomeAppbarfor dynamic layout flexibility.
๐งผ Cleanup #
- Improved documentation with usage examples and detailed parameter descriptions.
- Removed unnecessary keys and parameters like
faucetIconKeyfor simplification. - All predefined
TextStyleentries inCoconutTypographynow include consistentheightvalues for better vertical rhythm and layout consistency.
0.7.2 - 2025-04-15 #
โจ New Features #
CoconutAppBar- Explicitly set
SystemUiOverlayStylefor light mode to ensure consistent status bar appearance.
- Explicitly set
๐ Fixes & Improvements #
-
CoconutTextFieldactiveColoris now applied only when the field is focused, improving border color behavior.
-
CoconutButton- Fixed text alignment by wrapping label with
Centerto ensure both vertical and horizontal centering.
- Fixed text alignment by wrapping label with
-
CoconutTypography- Set default line height for better text layout consistency.
0.7.1 - 2025-04-02 #
โจ New Features #
CoconutAppBar- Added
titlePaddingparameter to allow custom padding around the title.
- Added
0.7.0 - 2025-03-28 #
โจ New Features #
-
CoconutAppBar- Added
heightandexpandedHeightproperties. - Added
bottomWidgetandpreferredSizeHeighttobuildHomeAppbar.
- Added
-
CoconutPulldownMenu- Added
buttonHeightandbuttonPaddingparameters. - Support for customizing dropdown shadow via
blurRadiusandspreadRadius.
- Added
-
CoconutPopup- Added
centerDescriptionparameter. - Added
ClipRRectand press effect. - Separated padding into
titlePaddinganddescriptionPadding. - Added customizable
TextStylefor title, description, and buttons.
- Added
-
CoconutTextField- Added
padding,height,textAlign,textInputAction,isLengthVisible, andfontFamilyparameters.
- Added
-
CoconutChip- Removed
childproperty. - Added:
label,labelFontFamily,labelSize,labelColorisSelected,hasOpacity,selectedBorderWidth,minWidth
- Removed
๐ Fixes & Improvements #
-
CoconutAppBar- Fixed alignment issue in
buildHomeAppbar.
- Fixed alignment issue in
-
CoconutTextField- Fixed border color logic.
- Unified error handling: replaced
isVisibleErrorTextwithisError.
-
CoconutUnderlinedButton- Fixed underline occupying entire screen width.
- Enabled touch detection in padding area.
-
CoconutChip- Changed
isSelectedto be nullable.
- Changed
-
CoconutPulldown- Refactored: Removed
dividerIndexanddividerPointColor, addeddividerHeightandborderRadius.
- Refactored: Removed
-
CoconutPopup- Adjusted button press opacity effect.
-
General
- Removed unnecessary
Containerusage in widget tree.
- Removed unnecessary
0.6.0 - 2025-02-25 #
โจ New Features #
- Added
CoconutFrostedAppBarโ A frosted glass effect app bar with adaptive status bar icon color. - Added
keysproperty toCoconutSegmentedControlโ Allows better state management by usingGlobalKey.
๐ Fixes & Improvements #
-
CoconutTooltip- Fixed opacity transition issue in tooltip animations.
- Added
baseBackgroundColorsupport for fixed tooltips.
-
CoconutTextField- Modified behavior to prevent disposal of
FocusNodeandTextEditingControllerindispose, considering external injection.
- Modified behavior to prevent disposal of
-
CoconutToast- General bug fixes and stability improvements.
-
CoconutBottomSheet- Fixed unintended UI behavior.
-
CoconutAppBar- Removed
hasRightIconparameter โ Now the app bar automatically determines if a right icon is needed. - Refactored
buildWithNextto derive brightness fromTheme.of(context)instead of using a default parameter.
- Removed
0.5.0 - 2025-02-14 #
๐ New Features #
- โจ Added
CoconutButtonโ Standard, Outlined, and Underlined Button components. - โจ Added
CoconutSegmentedControlโ A segmented button control for tab-based selections. - โจ Added
CoconutAppBarโ Customizable app bar with buttons and title support. - โจ Added
CoconutAppBarButtonโ A button component for use withinCoconutAppBar. - โจ Added
CoconutTooltipโ Provides fixed and floating tooltips. - โจ Added
CoconutToastโ Supports top and bottom toast notifications. - โจ Added
CoconutPopupโ A customizable popup dialog with title and description. - โจ Added
CoconutPulldownโ A dropdown menu for selecting options. - โจ Added
CoconutPulldownMenuโ A list-based pulldown menu for selections. - โจ Added
CoconutCheckboxโ Custom checkbox UI component. - โจ Added
CoconutSwitchโ A toggle switch component. - โจ Added
CoconutStepperโ A stepper UI for navigation flows. - โจ Added
CoconutChipโ A chip-style UI component. - โจ Added
CoconutTagChipโ A tag-style chip for filtering and selection. - โจ Added
CoconutTextFieldโ A themed text field component. - โจ Added
CoconutBottomSheetโ Supports modal and fixed bottom sheets. - โจ Added
CoconutBubbleClipperโ Custom clippers for tooltips and speech bubbles. - โจ Added
CoconutProgressIndicatorโ Animated progress bar indicator. - โจ Added
CoconutCircularIndicatorโ Lottie-based animated circular indicator. - โจ Added
CoconutIconโ Custom icon component for consistent theming. - โจ Added
CoconutColorSchemeโ Centralized color management. - โจ Added
CoconutTypographyโ Standardized text styles and font settings. - โจ Added
CoconutLayoutโ Layout-based spacing and size management. - โจ Added
CoconutSizesโ Predefined size values for spacing and UI components. - โจ Added
CoconutStylesโ Common UI styles and border radius settings.