Intro
React Pakistan is an OpenSource & Free Software (FOSS) platform, creating React software solutions for the global community.
The Motivation
It all started with, when there was a need to build custom UI for one of the clients and we realised that although we have several UI packages available i.e. MaterialUI, AntD and so many others but none of them allow full customisation as per your client's design specs.
So, we built up a collection of React Commons Components from the ground up, so that these components could then be used as per the client's design specs in any extended project.
Extending upon them, we built several production apps, for instance React UI Collection and other client's apps.
Also, there are helper packages like React Icon, React Logo and React Emoji collections, these packages contain 1000's of Reactified SVG's which can be customisable as per your specs.
There are some utils packages to reuse the code as much as possible across all shared repos.
Also, we abstracted, our ESlint rules across all packages to make it up to the defined standards.
Most codebase is built using TDD approach, hence reaching 90%+ coverage in some repos.
All codebase is written in TypeScript hence more robustibility.
The Architecture
The ReactPakistan Ecosystem
The eco-system is classified under generic to specific ways of building components library, this helps developers to re-use the generic components as much as possible and build specific stages of components on top of the generic ones, hence keeping the concerned component logic to it's relevant stage as required. Following is the higher level table to put things into perspective.
| Project | Generic/Specific Level |
|---|---|
React Commons Collection | Generic - 0 |
React UI Collection | Specific - 1 |
React Icon Collection | Specific - 1 |
React Logo Collection | Specific - 1 |
React Emoji Collection | Specific - 1 |
React Native Commons Collection | Generic - 0 |
React Native UI Collection | Specific - 1 |
React Native Icon Collection | Specific - 1 |
React Native Logo Collection | Specific - 1 |
React Native Emoji Collection | Specific - 1 |
Util Functions | Generic - 0 |
Util React Native Functions | Generic - 0 |
Eslint Config Shared | Generic - 0 |
OpenSource
Following is list of all React Pakistan repositories and their current status as of today.
| Project | GitHub | NPM | Open Source'd |
|---|---|---|---|
React Pakistan Docs | github | ❌ | ✅ |
React Commons Collection | github | npm | ❌ ETA: Q4 2024 |
React UI Collection | github | npm | ❌ ETA: Q4 2024 |
React Icon Collection | github | npm | ✅ |
React Logo Collection | github | npm | ✅ |
React Emoji Collection | github | npm | ✅ |
React Native Commons Collection | github | npm | ❌ ETA: Q4 2024 |
React Native UI Collection | github | npm | ❌ ETA: Q4 2024 |
React Native Icon Collection | github | npm | ✅ |
React Native Logo Collection | github | npm | ✅ |
React Native Emoji Collection | github | npm | ✅ |
React Native Boilerplate | github | ❌ | ✅ Refactor ETA: Q4 2021 |
Util Functions | github | npm | ❌ ETA: Q4 2024 |
Util React Native Functions | github | npm | ❌ ETA: Q4 2024 |
Eslint Shared Config | github | npm | ✅ |
Moving Forward
We shall continue to grow React Pakistan in all possible dimensions as possible, for the contributors.
How I can help React Pakistan
All we ask for, to use our packages from our NPM profile and let us know your feedback and ways how we could improve it even more. If you happen to like our repos/project, please consider giving a star on our GitHub.
Support
If you need any help or have any question, please feel free to join ReactPakistan community at React Pakistan Slack.
Contributors
Special thanks to all of our contributors who have put together all the bits and bobs of this project for the community. Should you wish to be React Pakistan contributor, please shoot an expression of interest at React Pakistan Email.