example — component gallery¶

A runnable Flutter app demonstrating every kh_ui widget, the kh_screens screens, and kh_utils's validators and formatters, themed via kh_theme. Manual-QA tooling (see PHASE_0_ARCHITECTURE.md §17.5) — not published, not a dependency of any other package.

What's in it¶

The home page lists one screen per area:

Screen	Shows
Buttons	every `KhButton` variant, size, pill and loading state
Components	`KhAvatar`, `KhSkeleton`/`KhShimmer`, `KhSearchField`, `KhSegmentedControl`, `KhSelectableChip`, `KhQuantityStepper`, `KhNetworkImage`, `KhOptionCard`, `KhStepIndicator`, `KhStatTile`
Text fields	`KhTextField` decorations, validation and obscured input
Form Controls	`KhCheckbox`, `KhRadio`/`KhRadioGroup`, `KhSwitch`, `KhDropdown`, `KhDatePicker`, `KhFieldLabel`
Cards	`KhCard`, including tappable cards
Chips & badges	`KhChip` and `KhBadge` in every semantic color, and `KhSnackbar`
Dialogs	`KhDialog.alert`/`.confirm`/`.success` and `KhBottomSheet`
Loading / empty / error states	`KhLoadingState`, `KhEmptyState`, `KhErrorState`
Screens	`kh_screens`: `KhSplashScreen`, `KhOnboardingFlow`, `KhLoginForm`
Navigation	`KhBottomNav` (standard, floating, pill) and `KhNavDrawer`
Validators (kh_utils)	`KhValidators` wired into live fields
Formatters (kh_utils)	`KhFormatters` output for dates, currency, numbers and phone numbers

Run it¶

melos bootstrap   # from the repo root, once
cd packages/example
flutter run

Test it¶

cd packages/example
flutter test

or, from the repo root, via Melos (covers every Flutter package with a test/ directory, including this one):

melos run test:flutter