Silky Scroll

SilkyScroll is a Flutter package that provides natural and smooth scroll animations for mouse wheel, trackpad, and touch inputs.

✨ SilkyScroll   ↔   Default

---

Features

• Smooth Scroll Animation — Interpolates mouse wheel input for seamless scrolling
• Smart Input Detection — Automatically detects mouse, trackpad, and touch to apply appropriate physics
• Edge Locking — Prevents unintended scroll propagation to parent views at scroll boundaries
• Stretch Effect — Supports Android stretch and iOS bounce overscroll effects
• Nested Scroll — Controls momentum bubbling in nested scroll views
• Horizontal Scroll — Supports both horizontal and vertical directions
• All Platforms — Android, iOS, Web, Windows, macOS, Linux

---

Getting Started

flutter pub add silky_scroll

---

Basic Usage

Simply wrap your scrollable widget with SilkyScroll.

SilkyScroll(
  builder: (context, controller, physics) => ListView(
    controller: controller,
    physics: physics,
    children: [...],
  ),
)

---

Custom Usage

You can connect an external ScrollController and fine-tune animation properties.

class _ScrollExampleState extends State<ScrollExample> {
  late final ScrollController _scrollController;

  @override
  void initState() {
    super.initState();
    _scrollController = ScrollController();
  }

  @override
  void dispose() {
    _scrollController.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: SilkyScroll(
        controller: _scrollController,
        physics: const BouncingScrollPhysics(),
        silkyScrollDuration: const Duration(milliseconds: 2000),
        scrollSpeed: 1.5,
        animationCurve: Curves.easeOutQuart,
        direction: Axis.vertical,
        builder: (context, controller, physics) {
          return ListView.builder(
            controller: controller,
            physics: physics,
            itemCount: 50,
            itemBuilder: (context, index) => ListTile(title: Text('Item $index')),
          );
        },
      ),
    );
  }
}

---

Using SilkyScrollConfig

You can share the same configuration across multiple SilkyScroll widgets.

const config = SilkyScrollConfig(
  silkyScrollDuration: Duration(milliseconds: 1000),
  scrollSpeed: 1.5,
  animationCurve: Curves.easeOutCubic,
  enableStretchEffect: true,
);

SilkyScroll.fromConfig(
  config: config,
  builder: (context, controller, physics) => ListView(...),
)

---

Parameters

Parameter	Type	Default	Description
controller	ScrollController?	null	External scroll controller
silkyScrollDuration	Duration	700ms	Scroll animation duration
scrollSpeed	double	1	Scroll speed multiplier
animationCurve	Curve	Curves.easeOutQuart	Animation curve
direction	Axis	vertical	Scroll direction
physics	ScrollPhysics	ScrollPhysics()	Scroll physics
edgeLockingDelay	Duration	650ms	Lock delay after reaching edge
overScrollingLockingDelay	Duration	700ms	Overscroll lock delay
enableStretchEffect	bool	true	Overscroll stretch effect
enableScrollBubbling	bool	false	Nested scroll momentum propagation
onScroll	Function(double)?	null	Scroll event callback
onEdgeOverScroll	Function(double)?	null	Edge overscroll callback
debugMode	bool	false	Debug logging

---

License

MIT