nylo-widgets

Nylo Built-in Widgets

Overview

Nylo v7 provides a rich widget library covering common UI patterns: toast notifications, bottom sheet modals, styled buttons with animation, list/grid rendering with pagination, async data display, pull-to-refresh, rich text, spacing, localization, and connectivity-aware layouts. These widgets integrate with Nylo's theme and state systems.

When to Use

• Showing toast notifications or alert dialogs
• Displaying bottom sheet modals
• Creating buttons with loading states, animations, or form submission
• Rendering lists or grids with pagination, sorting, and filtering
• Loading async data with loading/error states
• Adding pull-to-refresh to scrollable content
• Building rich text with mixed styles and tap handlers
• Adding consistent spacing between elements
• Translating text or switching languages
• Showing different UI based on network connectivity
• When NOT to use: for custom widgets unrelated to Nylo's built-in library, use standard Flutter widgets

Quick Reference

Widget	Purpose
showToastSuccess()	Success toast notification
showToastDanger()	Error toast notification
BottomSheetModal	Bottom sheet modal dialog
Button.primary()	Primary styled button
CollectionView<T>()	Type-safe list rendering
CollectionView<T>.pullable()	List with pagination + pull-to-refresh
CollectionView<T>.grid()	Grid layout
FutureWidget<T>()	Async data loader with loading state
FadeOverlay()	Gradient fade overlay on images
Pullable()	Pull-to-refresh wrapper
StyledText()	Rich text with mixed styles
StyledText.template()	Template-based rich text
Spacing.md	16px vertical space
TextTr("key")	Translated text widget
LanguageSwitcher()	Language selection dropdown
Connective()	Connectivity-aware widget

---

Alerts & Toast Notifications

Convenience Methods (in NyState/NyController)

showToastSuccess(description: "Saved successfully");
showToastWarning(description: "Check your input");
showToastInfo(description: "New update available");
showToastDanger(description: "Something went wrong");
showToastOops(description: "Oops!");    // danger style
showToastSorry(description: "Sorry!");  // danger style