Skip to main content

welkui_flutter 0.1.8 copy "welkui_flutter: ^0.1.8" to clipboard
welkui_flutter: ^0.1.8 copied to clipboard

Comic-inspired Flutter widgets for Android and iOS, with crisp outlines, hard shadows, bundled typography, and accessible mobile interactions.

WelkUI Flutter banner

WelkUI Flutter

pub.dev  ·  Documentation  ·  Contributing  ·  MIT License

Familiar WelkUI. Native Flutter. #

WelkUI Flutter brings the visual identity of the WelkUI React library to mobile apps with idiomatic Dart APIs and Flutter interactions. No Material elevation, gradients, or runtime font downloads.

  • Distinctive by default: asymmetric corners, crisp ink outlines, solid offset shadows, and the Short Stack typeface.
  • Made for touch: at least 48 logical-pixel interactive targets, visible tap feedback, and controlled state where it matters.
  • Accessibility built in: semantics, keyboard focus, RTL layout, text scaling, and reduced-motion support.
  • Easy to make yours: immutable theme tokens, local styling overrides, and locally bundled typography. QR encoding uses the pure-Dart qr package.

Full documentation: ui.welkdock.com/flutter

This README covers setup and the essentials. Visit the Flutter documentation for the full guide and a live preview of each widget.

Quick start #

For Android and iOS apps, install from pub.dev:

flutter pub add welkui_flutter

Or add the dependency to pubspec.yaml and run flutter pub get:

dependencies:
  welkui_flutter: ^0.1.5

Requires Dart 3.13.4+ and a compatible Flutter SDK satisfying 3.35.0+. Short Stack is bundled locally; no additional font setup is needed.

Widgets #

Controls & forms Content & navigation Overlays & utilities
WelkButton WelkAccordion WelkDialog
WelkIconButton WelkAvatar WelkDrawer
WelkCheckBox WelkBadge WelkTooltip
WelkRadio WelkBreadCrumbs WelkSnackBar
WelkRadioGroup WelkCard WelkAttachment
WelkSwitch WelkDivider WelkQRCode
WelkInput WelkImage WelkDateInput
WelkOTPInput WelkMenu WelkDatePicker
WelkDropDown WelkSticker WelkTimePicker
WelkRangeSlider WelkStickerCard WelkTabs

Global dark mode #

Set WelkThemeData.darkMode once in your app's WelkTheme to control dark mode globally. Rebuild the provider with data.copyWith(darkMode: true) or false to switch modes. When darkMode is null (the default), widgets follow Flutter's ThemeData.brightness.

All WelkUI widgets consume the dark-mode preference, including controls, content, pickers, and overlays. The example app includes a floating WelkIconButton theme toggle on non-embedded screens.

WelkTheme(
  data: const WelkThemeData(darkMode: true),
  child: MaterialApp(home: MyHomePage()),
)

Set overRideDarkMode on any widget to force dark (true) or light (false), regardless of the global setting. Omit it to inherit. Container overrides also flow into nested WelkUI widgets; dialog, drawer, and snackbar show functions accept the same override.

Place the global WelkTheme above MaterialApp so open popups and overlays can also follow its updates. Local themes are carried into overlays when opened.

Dark mode adds a 10% black tint to semantic variant fills, with black borders, whitish-gray hard shadows, and contrasting text and icons. Secondary buttons use a charcoal-gray surface, and ghost buttons remain transparent. Neutral surfaces and text adapt to dark mode. QR modules retain a light backing and dark modules for scanning. Avatar portraits use black assets in light mode and white assets in dark mode; custom icons and profile images are not filtered. Customize the dark palette with darkPaper, darkMuted, darkInk, darkOutline, darkShadow, darkButtonTint, and darkFocus design tokens.

WelkButton(
  overRideDarkMode: true,
  variant: WelkButtonVariant.secondary,
  onPressed: () {},
  child: const Text('Continue'),
)

Contributing & license #

See the contribution guidelines for setup and pull requests. Released under the MIT License; the bundled Short Stack font uses the SIL Open Font License 1.1.

9
likes
0
points
1.46k
downloads

Publisher

verified publisherwelkdock.com

Weekly Downloads

Comic-inspired Flutter widgets for Android and iOS, with crisp outlines, hard shadows, bundled typography, and accessible mobile interactions.

Repository (GitHub)
View/report issues

License

unknown (license)

Dependencies

flutter, qr

More

Packages that depend on welkui_flutter