Skip to content

Commit

Permalink
update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
dimaportenko committed Oct 19, 2023
1 parent ca77b52 commit 4131b9c
Show file tree
Hide file tree
Showing 3 changed files with 37 additions and 6 deletions.
3 changes: 2 additions & 1 deletion .nvim/config.json
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
{
"commands": {
"run:example:ios": "yarn example ios",
"run:example:ios:clear": "yarn example ios --clear"
"run:example:ios:clear": "yarn example ios --clear",
"npm:publish": "npm publish --access public"
}
}
40 changes: 35 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,20 +2,43 @@

Unveiling the React Native Liquid Gauge, a charming and highly customizable UI component engineered to represent progress in a visually intuitive manner. This library is built on top of react-native-skia, ensuring smooth rendering and high performance across different platforms while making it easier to integrate within your React Native projects.

![demo](https://raw.githubusercontent.com/dimaportenko/react-native-liquid-gauge/main/docs/demo.gif)

## Installation

This library has peer dependencies on [react-native-skia](https://shopify.github.io/react-native-skia/docs/getting-started/installation/), [react-native-reanimated](https://docs.swmansion.com/react-native-reanimated/docs/fundamentals/getting-started/#installation), [d3](https://www.npmjs.com/package/d3) and for typescript [@types/d3](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/d3)

```sh
npm install react-native-liquid-gauge
npm install react-native-liquid-gauge @shopify/react-native-skia react-native-reanimated d3
npm install --save-dev @types/d3
```

Follow additional steps on the libraries documentaiton page [react-native-skia](https://shopify.github.io/react-native-skia/docs/getting-started/installation/), [react-native-reanimated](https://docs.swmansion.com/react-native-reanimated/docs/fundamentals/getting-started/#installation).

## Usage

```js
import { multiply } from 'react-native-liquid-gauge';
Take a look example directory

// ...
```js

const result = await multiply(3, 7);
// with default config
<LiquidGauge value={60} />

// or with custom config
<LiquidGauge
config={{
circleColor: '#FF7777',
textColor: '#FF4444',
waveTextColor: '#FFAAAA',
waveColor: '#FFDDDD',
circleThickness: 0.2,
textVertPosition: 0.2,
waveAnimateTime: 1000,
}}
value={30}
width={200}
height={200}
/>
```

## Contributing
Expand All @@ -29,3 +52,10 @@ MIT
---

Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)

# TODO

- [ ] publish to npm
- [ ] test install as npm package
- [ ] add github action to publish to npm
- [ ] add readme
Binary file added docs/demo.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 4131b9c

Please sign in to comment.