React Native component for creating animated, circular progress with ReactART
Switch branches/tags
Nothing to show
Clone or download
Jacse Merge pull request #157 from brendannee/patch-1
Added units and defaults for animation duration
Latest commit 0e3796a Sep 18, 2018

license Version npm


React Native component for creating animated, circular progress. Useful for displaying users points for example. Works on iOS & Android.

Example app



  1. Install this component and react-native-svg:

npm i --save react-native-circular-progress react-native-svg

  1. Link native code for SVG:

react-native link react-native-svg


Import CircularProgress or AnimatedCircularProgress:

import { AnimatedCircularProgress } from 'react-native-circular-progress';

Use as follows:

  onAnimationComplete={() => console.log('onAnimationComplete')}
  backgroundColor="#3d5875" />

You can also define a function, that'll receive current progress and for example display it inside the circle:

    (fill) => (
      <Text style={styles.points}>
        { this.state.fill }

Finally, you can manually trigger a duration-based timing animation by putting a ref on the component and calling the animate(toValue, duration, easing) function like so:

  ref={(ref) => this.circularProgress = ref}
this.circularProgress.animate(100, 8000, Easing.quad); // Will fill the progress bar linearly in 8 seconds

The animate-function returns the timing animation so you can chain, run in parallel etc.


You can configure the passing by following props:

  • size – width and height of the circle - could be number or object if you use Aniamted.Value()
  • width - thickness of the lines
  • backgroundWidth - thickness of the background line
  • fill - current, percentage fill (from 0 to 100)
  • prefill - percentage fill before the animation (from 0 to 100)
  • tintColor - color of the progress line
  • backgroundColor - color of the background for the progress line. If unspecified, no background will be rendered
  • rotation - by default, progress starts from the angle = 90⦝, you can change it by setting value from -360 to 360
  • duration - duration of the animation in milliseconds. Default is 500ms
  • easing - animation easing function
  • lineCap - the shape to be used at the ends of the circle. Possible values: butt (default), round or square. (see here)
  • arcSweepAngle - the angle that you want your arc to sweep in the case where you don't want a full circle. Default is 360.
  • children(fill) - you can pass function as a child to receive current fill
  • onAnimationComplete - you can pass a callback function that will be invoked when animation completes. (see here)

Running example app

git clone
cd react-native-circular-progress/example
yarn start


Bartosz Gryszko (



Special thanks

Special thanks to Chalk+Chisel for creating working environment where people grow. This component was created for one of the projects we're working on.