# react-simple-pull-to-refresh > A Simple Pull To Refresh Component for React Application Latest version **1.3.4** (published 2026-01-05) · MIT license · 0 weekly downloads ## Install ```sh npm install react-simple-pull-to-refresh pnpm add react-simple-pull-to-refresh yarn add react-simple-pull-to-refresh bun add react-simple-pull-to-refresh ``` ## Health **Score 55/100 (C)** — status: stable. Positive: has types; esm support; no vulnerabilities. Warnings: low downloads. ## Facts | | | |---|---| | Version | 1.3.4 | | Published | 2026-01-05 | | First published | 2019-11-06 | | Weekly downloads | 0 | | License | MIT | | TypeScript types | bundled | | Module format | ESM + CommonJS | | Dependencies | 0 | | Unpacked size | 36.7 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 191 | | Author | Guibert Thomas | | Maintainers | thmsgbrt | | Keywords | react, pull to refresh, js, mobile | ## Links - npm: https://www.npmjs.com/package/react-simple-pull-to-refresh - Repository: https://github.com/thmsgbrt/react-simple-pull-to-refresh - Homepage: https://github.com/thmsgbrt/react-simple-pull-to-refresh#readme - Issues: https://github.com/thmsgbrt/react-simple-pull-to-refresh/issues - npm.io page: https://npm.io/package/react-simple-pull-to-refresh ## Alternatives - [@mapbox/jsonlint-lines-primitives](https://npm.io/package/@mapbox/jsonlint-lines-primitives.md) — 5.3M weekly downloads - [reftools](https://npm.io/package/reftools.md) — 3.5M weekly downloads - [@hey-api/openapi-ts](https://npm.io/package/@hey-api/openapi-ts.md) — 3.5M weekly downloads - [@mapbox/geojson-rewind](https://npm.io/package/@mapbox/geojson-rewind.md) — 2.4M weekly downloads - [turbo-stream](https://npm.io/package/turbo-stream.md) — 1.7M weekly downloads ## Recent versions - 1.3.4 (latest) — 2026-01-05 - 1.3.3 — 2022-08-07 - 1.3.2 — 2022-07-18 - 1.3.1 — 2022-07-17 - 1.3.0 — 2021-10-19 - 1.2.5 — 2021-10-19 - 1.2.4 — 2021-10-17 - 1.2.3 — 2021-02-02 - 1.2.2 — 2021-01-25 - 1.2.1 — 2020-12-30 - 1.2.0 — 2020-06-08 - 1.1.2 — 2019-12-28 - 1.1.1 — 2019-12-24 - 1.1.0 — 2019-12-04 - 1.0.10 — 2019-12-04 - … 10 more at https://npm.io/package/react-simple-pull-to-refresh/versions ## README # react-simple-pull-to-refresh [![npm version](https://badge.fury.io/js/react-simple-pull-to-refresh.svg)](https://badge.fury.io/js/react-simple-pull-to-refresh) [![license](https://img.shields.io/github/license/thmsgbrt/react-simple-pull-to-refresh.svg)](https://github.com/thmsgbrt/react-simple-pull-to-refresh/blob/master/LICENSE) ![](https://badgen.net/npm/types/react-simple-pull-to-refresh) ![](https://badgen.net/badge/maintained/yes/green) A Simple Pull-To-Refresh Component for React Application with 0 dependency. Works for Mobile and Desktop. ## Contributing ⚠️ I don't have much time to take care of the issues at the moment. 🙏 Any help and contribution is greatly appreciated. ## Demo [Click here 👍](https://thmsgbrt.github.io/react-simple-pull-to-refresh) ## Installation `npm i react-simple-pull-to-refresh` ## Usage ```jsx import PullToRefresh from 'react-simple-pull-to-refresh'; ``` Pull To Refresh only ```jsx // ... return ( ); // ... ``` Pull To Refresh and Fetch More enabled ```jsx // ... return ( ); // ... ``` ## Props Matrix | Name | Type | Required | Default | Description | | :-----------------: | :-------------------: | :------: | :-------------------: | ---------------------------------------------------------------------------- | | isPullable | boolean | false | true | Enable or disable pulling feature | | onRefresh | () => Promise | true | | Function called when Refresh Event has been trigerred | | pullDownThreshold | number | false | 67 | Distance in pixel to pull to trigger a Refresh Event | | maxPullDownDistance | number | false | 95 | Maximum transitionY applied to Children when dragging | | resistance | number | false | 1 | Scale of difficulty to pull down | | refreshingContent | JSX.Element or string | false | | Content displayed when Pulling or Fetch more has been trigerred | | pullingContent | JSX.Element or string | false | | Content displayed when Pulling | | canFetchMore | boolean | false | false | Enable or disable fetching more feature | | onFetchMore | () => Promise | false | | Function called when Fetch more Event has been trigerred | | fetchMoreThreshold | number | false | 100 | Distance in pixel from bottom of the container to trigger a Fetch more Event | | backgroundColor | string | false | | Apply a backgroundColor | | className | string | false | | | ## Changelog 1.3.3: Update package.json peerDependencies to support react 18 - (From: [@mjauernig](https://github.com/mjauernig)) 1.3.2: Fix build issue encountered with 1.3.1 1.3.1: Fix issue preventing fixed elements to work properly - (From: [@ManuDoni](https://github.com/ManuDoni)) 1.3.0: Add a _resistance_ prop, that allows to adjust the pull down difficulty - (From: [@joshuahiggins](https://github.com/joshuahiggins)) 1.2.5: Fix event listenter leaks - (From: [@d-s-x](https://github.com/d-s-x)) 1.2.4: Fix overscroll on iOS Safari - (From: [@d-s-x](https://github.com/d-s-x)) 1.2.3: Add React 17+ as valid peer dependencies - (From: [@Felixmosh](https://github.com/felixmosh)) 1.2.2: Remove non-null assertion operators from ref.current + TouchEvent check for Mozilla - (From: [@HamAndRock](https://github.com/HamAndRock)) 1.2.1: Remove unnecessary z-index 1.2.0: onRefresh and onFetchMore now require to be of type () => Promise 1.1.2: Bind Scroll event to Window 1.1.0: Check for "canFetchMore" value for each scroll events. 1.1.0: Add a Fetch More feature --- _Source: https://npm.io/package/react-simple-pull-to-refresh · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._