Widget
Live preview and documentation for the Widget component.
Preview
componentPreview.loading
About
Unlike the other items in the catalog, this isn't a reusable UI component inside the app — it's the visual mockup of the operating system's home screen widget (iOS WidgetKit / Android App Widget), the feature that lets a user pin a mini-panel of the app to their phone's home screen or lock screen.
What shows up in the preview (KasyWidgetPreview) is just a design mockup within the design system, meant to decide on the visuals before wiring up the real native implementation (home_widget / WidgetKit / App Widget):
value: the main highlighted text (e.g. a day count, a balance).label: caption below the value.size:KasyWidgetPreviewSize.small(square, default) or.medium(wide rectangle, two cells) — mirrors iOS/Android widget sizes.
Purely presentational: it doesn't render an actual widget on the home screen, nor does it read real app data — it's the visual reference the native implementation should follow.
Last updated on 08/23/2026