diff --git a/packages/animated-circle/README.md b/packages/animated-circle/README.md
index c2baa20c..45c214ff 100644
--- a/packages/animated-circle/README.md
+++ b/packages/animated-circle/README.md
@@ -1,17 +1,51 @@
 # @nativescript/animated-circle
 
-```bash
+A plugin that creates a circular progress bar on iOS and Android.
+
+| ![Android animated circle demo video](/packages/animated-circle/images/animated-circle-android.gif) | ![iOS animated circle demo video](/packages/animated-circle/images/animated-circle-ios.gif) |
+| :-------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------ |
+| `Android`                                                                                           | `iOS`                                                                                       |
+
+## Contents
+
+- [Installation](#installation)
+- [Use @nativescript/animated-circle](#use-nativescriptanimated-circle)
+  - [Core](#core)
+  - [Angular](#angular)
+  - [Vue](#vue)
+  - [Svelte](#svelte)
+  - [React](#react)
+- [API](#api)
+- [License](#license)
+
+## Installation
+
+```cli
 npm install @nativescript/animated-circle
 ```
 
-Creates an animated circle (animates the border of the circle) on iOS and Android.
-
-## Using animated-circle
+## Use @nativescript/animated-circle
 
 ### Core
+
+1. Register the plugin namespace with Page's `xmlns` attribute providing your prefix( `ui`, for example).
+
+```xml
+<Page xmlns:ui="@nativescript/animated-circle">
+```
+
+2. Access the `AnimatedCircle` view through the prefix.
+
+```xml
+<ui:AnimatedCircle ... />
+```
+
+The result of the previous steps will be the following:
+
 ```xml
 <Page xmlns="http://schemas.nativescript.org/tns.xsd"
   xmlns:ui="@nativescript/animated-circle">
+
     <ui:AnimatedCircle
         backgroundColor="transparent"
         width="200"
@@ -23,23 +57,44 @@ Creates an animated circle (animates the border of the circle) on iOS and Androi
         fillColor="#eee"
         clockwise="true"
         rimWidth="5"
-        progress="80"
-        text="bam"
+        progress="{{ circleProgress }}"
+        text="{{ circleProgress + '%'}}"
         textSize="28"
         textColor="red" />
 </Page>
 ```
+
+---
+
+### Angular
+
+1. Add `NativeScriptAnimatedCircleModule` to the module imports where you want to use the view.
+
+```typescript
+import { NativeScriptAnimatedCircleModule } from '@nativescript/animated-circle/angular';
+imports: [NativeScriptAnimatedCircleModule];
+```
+
+2. Use the view in HTML.
+
+```xml
+<AnimatedCircle backgroundColor="transparent" width="200" height="200" animated="true" animateFrom="0" rimColor="#fff000" barColor="#ff4081" rimWidth="25" [progress]="circleProgress" [text]="progress + '%'" textSize="22" textColor="#336699"></AnimatedCircle>
+```
+
 ---
+
 ### Vue
 
-Register the plugin in the `app.ts`:
+1. Register the view in the `app.ts` file.
+
 ```ts
 import { registerElement } from 'nativescript-vue';
 
-registerElement("AnimatedCircle", ()=> require("@nativescript/animated-circle").AnimatedCircle)
+registerElement('AnimatedCircle', () => require('@nativescript/animated-circle').AnimatedCircle);
 ```
 
-Then in a `.vue` file:
+2. Use the view in a `.vue` file.
+
 ```xml
 <AnimatedCircle
         backgroundColor="transparent"
@@ -52,43 +107,116 @@ Then in a `.vue` file:
         fillColor="#eee"
         clockwise="true"
         rimWidth="5"
-        progress="80"
-        text="bam"
+        :progress="progress"
+        :text="progress + '%'"
         textSize="28"
         textColor="red" />
 ```
+
 ---
-### Angular
 
-- Add the NativeScriptAnimatedCircleModule to your module imports where you will use the plugin.
+### Svelte
 
-```typescript
-import { NativeScriptAnimatedCircleModule } from '@nativescript/animated-circle/angular';
-imports: [NativeScriptAnimatedCircleModule];
+1. Register the plugin's view in the `app.ts` file.
+
+```ts
+import { registerNativeViewElement } from 'svelte-native/dom';
+
+registerNativeViewElement('animatedCircle', () => require('@nativescript/animated-circle').AnimatedCircle);
+```
+
+2. Use the view in markup.
+
+```xml
+<animatedCircle
+    backgroundColor="transparent"
+    width="200"
+    height="200"
+    animated="true"
+    animateFrom="0"
+    rimColor="#C4BF55"
+    barColor="#000"
+    clockwise="true"
+    rimWidth="20"
+    progress={ circleProgress }
+    text="80%"
+    textSize="28"
+    textColor="red"
+    />
 ```
 
+---
+
+### React
+
+1. Register the plugin's view in the `app.ts` file.
+
+```ts
+interface AnimatedCircleAttributes extends ViewAttributes {
+	progress?: number;
+	animated?: boolean;
+	animateFrom?: number;
+	text?: string;
+	textSize?: number;
+	textColor?: string;
+	rimColor?: string;
+	barColor?: string;
+	rimWidth?: number;
+	clockwise?: boolean;
+}
+
+declare global {
+	module JSX {
+		interface IntrinsicElements {
+			animatedCircle: NativeScriptProps<AnimatedCircleAttributes, AnimatedCircle>;
+		}
+	}
+}
+
+registerElement('animatedCircle', () => require('@nativescript/animated-circle').AnimatedCircle);
+```
+
+2. Use the view in markup.
+
 ```xml
-<AnimatedCircle backgroundColor="transparent" width="200" height="200" animated="true" animateFrom="0" rimColor="#fff000" barColor="#ff4081" rimWidth="25" progress="{{ circleProgress }}" text="" textSize="22" textColor="#336699"></AnimatedCircle>
+<stackLayout marginTop={30}>
+  <animatedCircle
+      backgroundColor="transparent"
+      width={200}
+      height={200}
+      animated={true}
+      animateFrom={0}
+      rimColor="#000"
+      barColor="#C4BF55"
+      clockwise={true}
+      rimWidth={20}
+      progress={this.state.progress}
+      text={this.state.progress + '%'}
+      textSize={28}
+      textColor="#000"
+  />
+</stackLayout>
 ```
+
 ---
-## API Reference
 
+## API Reference
 
-| Property          | Type | Default | Description                                            |
-| ----------------- |------| ------- | ------------------------------------------------------ |
-| `rimColor`          | [Color](https://blog.nativescript.org/guide/core/color)| `#FF5722` | The filled portion of the circle border's color.       |
-| `barColor`          |[Color](https://blog.nativescript.org/guide/core/color)| `#3D8FF4` | The remaining (unfilled) portion of the circle border. |
-| `rimWidth`          | `number` |`5`       | The border radius of the circle.                       |
-| `progress`          | `number` |`0 `      | The current progress value.                            |
-| `startAngle`        | `number` |`0`       | The angle to start drawing from.                       |
-| `endAngle`          | `number` |`100`     | _iOS only_ the end angle to stop drawing at.           |
-| `animated`          | `boolean` |`false`   | _Android only_ animation status.                       |
-| `animateFrom`       | `number` |`0`       | _Android only_ the progress value to animate from.     |
-| `animationDuration` | `number` |`1000`    | _Android only_ the duration to animate for.            |
-| `text`              | `string` |`""`      | The text inside of the circle.                         |
-| `textSize `         | `number` |`0`       | Text size, 0 will hide the text                        |
-| `textColor`         | [Color](https://blog.nativescript.org/guide/core/color) |`#ff0000` | Text color                                             |
+| Property            | Type                                                    | Default   | Description                                            |
+| ------------------- | ------------------------------------------------------- | --------- | ------------------------------------------------------ |
+| `rimColor`          | [Color](https://blog.nativescript.org/guide/core/color) | `#FF5722` | The filled portion of the circle border's color.       |
+| `barColor`          | [Color](https://blog.nativescript.org/guide/core/color) | `#3D8FF4` | The remaining (unfilled) portion of the circle border. |
+| `rimWidth`          | `number`                                                | `5`       | The border radius of the circle.                       |
+| `progress`          | `number`                                                | `0 `      | The current progress value.                            |
+| `startAngle`        | `number`                                                | `0`       | The angle to start drawing from.                       |
+| `endAngle`          | `number`                                                | `100`     | _iOS only_ the end angle to stop drawing at.           |
+| `animated`          | `boolean`                                               | `false`   | _Android only_ animation status.                       |
+| `animateFrom`       | `number`                                                | `0`       | _Android only_ the progress value to animate from.     |
+| `animationDuration` | `number`                                                | `1000`    | _Android only_ the duration to animate for.            |
+| `text`              | `string`                                                | `""`      | The text inside of the circle.                         |
+| `textSize `         | `number`                                                | `0`       | Text size, 0 will hide the text                        |
+| `textColor`         | [Color](https://blog.nativescript.org/guide/core/color) | `#ff0000` | Text color                                             |
 
 ## License
 
-Apache License Version 2.0
\ No newline at end of file
+Apache License Version 2.0
diff --git a/packages/animated-circle/images/animated-circle-android.gif b/packages/animated-circle/images/animated-circle-android.gif
new file mode 100644
index 00000000..a866bc3b
Binary files /dev/null and b/packages/animated-circle/images/animated-circle-android.gif differ
diff --git a/packages/animated-circle/images/animated-circle-ios.gif b/packages/animated-circle/images/animated-circle-ios.gif
new file mode 100644
index 00000000..e743ff0b
Binary files /dev/null and b/packages/animated-circle/images/animated-circle-ios.gif differ