Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/react-pakistan/react-native-icon-collection
React Native Icon Collection built upon React Native StoryBook
https://github.com/react-pakistan/react-native-icon-collection
react react-native storybook styled-components typescript
Last synced: 7 days ago
JSON representation
React Native Icon Collection built upon React Native StoryBook
- Host: GitHub
- URL: https://github.com/react-pakistan/react-native-icon-collection
- Owner: react-pakistan
- License: mit
- Created: 2020-02-11T13:25:12.000Z (almost 5 years ago)
- Default Branch: dev
- Last Pushed: 2023-01-27T09:59:37.000Z (almost 2 years ago)
- Last Synced: 2024-11-29T17:50:02.543Z (24 days ago)
- Topics: react, react-native, storybook, styled-components, typescript
- Language: TypeScript
- Homepage:
- Size: 16.3 MB
- Stars: 0
- Watchers: 2
- Forks: 1
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
# π React Pakistan π₯π₯π₯
React Pakistan is an OpenSource & Free Software (FOSS) platform, creating React software solutions for the global community. βββ
[![License](https://img.shields.io/github/license/react-pakistan/react-native-boilerplate.svg)](https://github.com/react-pakistan/react-native-boilerplate/blob/master/LICENSE)
[![Followers](https://img.shields.io/github/followers/taimoormk.svg?style=social)](https://github.com/taimoormk)
[![Forks](https://img.shields.io/github/forks/react-pakistan/react-native-boilerplate.svg?style=social)](https://github.com/react-pakistan/react-native-boilerplate)
[![Stars](https://img.shields.io/github/stars/react-pakistan/react-native-boilerplate.svg?style=social)](https://github.com/react-pakistan/react-native-boilerplate)[![Maintenance](https://img.shields.io/badge/Maintained%3F-yes-green.svg)](https://GitHub.com/Taimoormk/StrapDown.js/graphs/commit-activity)
![Maintaner](https://img.shields.io/badge/maintainer-TaimoorKhan-blue)
[![Website shields.io](https://img.shields.io/website-up-down-green-red/http/shields.io.svg)](http://shields.io/)
[![Ask Me Anything !](https://img.shields.io/badge/Ask%20me-anything-1abc9c.svg)](https://GitHub.com/Taimoormk/ama)[![Ryo-ma's github trophy](https://github-profile-trophy.vercel.app/?username=Taimoormk&row=1)](https://github.com/ryo-ma/github-profile-trophy)
[![DenverCoder1's github streak](https://github-readme-streak-stats.herokuapp.com/?user=Taimoormk&theme=blue-green)](https://github.com/DenverCoder1/github-readme-streak-stats)
[![Sparkline](https://stars.medv.io/Naereen/badges.svg)](https://stars.medv.io/react-pakistan/react-native-icon-collection)
[![saythanks](https://img.shields.io/badge/say-thanks-ff69b4.svg)](https://saythanks.io/to/Taimoormk)
## π React Native Icon Collection β
A generic, Icon library for React Native apps, following modern approach by building your project's UI in isolation using state of the art Storybook along with React.
### π Table of Contents π
- [Technology Stack](#-technology-stack-) β¨
- [Installation](#-installation-) β¨
- [Usage](#-usage-) β¨
- [Styles](#-styles-) β¨
- [Tested](#-tested-) β¨
- [Contributors](#-contributors-) β¨
- [Other Libraries from ReactPakistan](#-other-libraries-from-reactpakistanβ) β¨
- [Support](#-support-) β¨
- [Contact](#-contact-) β¨
- [Buy Me Coffee](#-buy-me-coffee-) β¨### π Technology Stack π
- [React](https://reactjs.org/) β¨
- [React Native](https://reactnative.dev/) β¨
- [Storybook](https://storybook.js.org/) β¨
- [TypeScript](https://www.typescriptlang.org/) β¨
- [JavaScript](https://javascript.info/) β¨
- [Styled Components](https://styled-components.com/) β¨
- [Jest](https://jestjs.io/) β¨
- [Eslint](https://eslint.org/) β¨### π Installation π
- You should have React Native environment setup, prior proceeding with the following steps, if you don't please refer to [React Native Getting Started docs](https://reactnative.dev/docs/getting-started) to setup that.
- Clone the repo
- Cd into the project folder
- Figure out which package manager you have on your system, then run following commands for their specific use cases.
```console
// to install dependencies
yarn
// to build and run app on ios Simulator
yarn ios
// to build and run app on android Simulator
yarn android
// to run all tests locally
yarn test
```
OR
```console
// to install dependencies
npm install
// to build and run app on ios Simulator
npm run ios
// to build and run app on android Simulator
npm run android
// to run all tests locally
npm test
```### π Usage π
Add React Native Icon Collection to your project.
```console
yarn add @react-pakistan/react-native-icon-collection
```
OR
```console
npm install @react-pakistan/react-native-icon-collection
```Add React Native Icon Collection base theme to your project.
```console
yarn add @react-pakistan/util-react-native-functions
```
OR
```console
npm install @react-pakistan/util-react-native-functions
```Refer to [React Pakistan Docs](https://react-pakistan.github.io/react-pakistan-docs) for detail usage docs.
### π Styles π
Styled Components are employed to maintain and update theme for this project. Please consider adding Styled Component Provider wrapper to the entry point of your application, following is the sample code.
You could either use the default theme as shown below or wire your custom theme object instead.```javascript
import { ThemeProvider } from 'styled-components';
import { theme } from '@react-pakistan/util-functions';
```### π Tested π
Since we wrote a script that generates all the logos on the fly, we don't feel the need to test all 1000's of React SVG components.
Should you like this project and would like to see more coming in future, please consider giving a β on Github project repo.
### π Contributors π
Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
| Contributors | GitHub | Emoji |
| ------------- |:-------------:|:-----:|
| | Taimoor Khan | π¨π€π§ππβ οΈ |### π Other Libraries from ReactPakistan π
### π Support π
If you need any help or have any question, please feel free to join ReactPakistan community at [React Pakistan Slack](reactpakistan.slack.com).
### π Contact π
I can be reachable via [Taimoor Web](https://taimoor.io) or else should you wish to send over an expression of your interest to contribute towards ReactPakistan, please shoot an [email](mailto:[email protected]).
### π Buy me Coffee π