flutterchina/flukit

Flukit is a Flutter UI widget library written in Dart, published as a package on pub.dartlang.org. It provides a set of ready-made widgets and utility classes that address common UI needs in Flutter applications, covering animation, layout, scrollable views, and debugging. On the visual side, the library includes gradient-background buttons, a circular progress indicator that supports gradient colors along its arc, a pinch-to-zoom view that also responds to double taps, an image carousel or swiper, a draggable scrollbar for long lists, and a pull-to-refresh component that triggers a refresh animation after the user lifts their finger. A TurnBox widget rotates its child to any angle with a smooth animation, and a WaterMark widget tiles a text or image pattern across a view. For scrollable content built with CustomScrollView, Flukit adds a SliverFlexibleHeader whose height stretches elastically as the user pulls down, similar to the spring effect seen on profile pages in some mobile apps. A SliverPersistentHeaderToBox variant simplifies setting up a sticky header by accepting a regular Box widget child without the usual delegate boilerplate. Several widgets help during development. LayoutLogPrint prints the layout constraints a parent passes to its child, which is useful when debugging unexpected widget sizing. LogListenerScope, VerticalLogPanel, and LogPanel intercept print output from anywhere in the app and display it in the UI itself, so developers can read logs without switching to a terminal. The AfterLayout widget provides access to a widget's RenderObject immediately after its first layout pass. The README and documentation are written primarily in Chinese. A contribution guide is included for developers who want to add new widgets.