unrefresh

A component-oriented pull-to-refresh interaction for web interfaces.

Overview

unrefresh is a small interaction utility for building pull-to-refresh behavior in web interfaces. The goal is to make a familiar mobile gesture easier to add to component-based applications without coupling the page to a specific product layout.

Why I Built It

Pull-to-refresh often looks simple, but the details are easy to get wrong: gesture distance, release threshold, loading state, reset timing, and scroll-container boundaries all need to feel predictable. unrefresh packages those concerns into a reusable interaction layer.

What It Focuses On

  • Component-friendly usage.
  • Clear gesture threshold behavior.
  • Loading and reset states.
  • Mobile-first interaction details.
  • A small API surface for product pages.

Roadmap

  • Basic pull gesture flow
  • Refresh state handling
  • More examples
  • Better TypeScript documentation
  • Framework-specific demos
back