|
1 | | -# :octocat: React Github UI Clone |
| 1 | +<h1 align="center"> |
| 2 | + React Github UI Clone |
| 3 | +</h1> |
| 4 | + |
| 5 | +<h4 align="center"> |
| 6 | + A clone of the user interface of the Github. With the top 6 repositories of a user based on the stars amount of each repository, using the Github API. |
| 7 | +</h4> |
| 8 | + |
| 9 | +<p align="center"> |
| 10 | + <img alt="Repo's top language" src="https://img.shields.io/static/v1?label=Main%20technology&message=TypeScript%2FReact&style=for-the-badge&color=2b7489&labelColor=000000"> |
| 11 | + <img alt="Repository size" src="https://img.shields.io/static/v1?label=Repo%20size&message=250%20KB&style=for-the-badge&color=2b7489&labelColor=000000"> |
| 12 | +</p> |
| 13 | + |
| 14 | +<p align="center"> |
| 15 | + <a href="#technologies">Used Technologies</a> | |
| 16 | + <a href="#objective">Project's goal</a> | |
| 17 | + <a href="#final-result">Final Result</a> | |
| 18 | + <a href="#how-to-use">How to Run</a> | |
| 19 | + <a href="#features">Features</a> |
| 20 | +</p> |
| 21 | + |
| 22 | +<h3 align="center"> |
| 23 | + <img src="Preview.png" width="750"> |
| 24 | +</h3> |
| 25 | + |
| 26 | +<p align="center"> |
| 27 | + <a href="https://react-github-clone.netlify.app/" target="_blank"> |
| 28 | + <img alt="Demo on Netlify" src="https://res.cloudinary.com/lukemorales/image/upload/v1563043495/readme_logos/demo_on_netlify_bbuvjz.png"> |
| 29 | + </a> |
| 30 | +</p> |
| 31 | + |
| 32 | +<h2 id="techonologies" name="technologies"> |
| 33 | + :rocket: Used Technologies |
| 34 | +</h2> |
| 35 | + |
| 36 | +- [ReactJS with TypeScript](https://pt-br.reactjs.org/) to build the app in general |
| 37 | +- [Styled Components](https://styled-components.com/) to style all the app(components, views and so on) |
| 38 | +- [React Router](https://reactrouter.com/) to make multiple routes |
| 39 | +- [Sweet Alert](https://sweetalert.js.org/) to make some toast messages |
| 40 | +- [Axios](https://github.com/axios/axios) to make the all the requests to the API |
| 41 | +- [Github REST API](https://docs.github.com/en/rest) to get all the data that the app uses |
| 42 | + |
| 43 | +<h2 id="objective" name="objective"> |
| 44 | + :dart: Project's goal |
| 45 | +</h2> |
| 46 | + |
| 47 | +The aim of this project was practicing React with TypeScript, two techs that I'm liking really much and working hard to improve in them. |
| 48 | + |
| 49 | +<h2 id="final-result" name="final-result"> |
| 50 | + :arrow_forward: Final Result |
| 51 | +</h2> |
| 52 | + |
| 53 | +### [You can check the final result clicking here](https://react-github-clone.netlify.app/) |
| 54 | + |
| 55 | +<h2 id="features" name="features"> |
| 56 | + :clipboard: Features |
| 57 | +</h2> |
| 58 | + |
| 59 | +- Dynamic fetching of a Github user using the Github REST API |
| 60 | +- Dynamic sorting of the top 6 repositories of the user, this top 6 is based on the amount of stars of each repository |
| 61 | +- Light and Dark theme |
| 62 | +- Responsive design |
| 63 | +- Loading animation and errors messages |
| 64 | + |
| 65 | +<h2 id="how-to-use" name="how-to-use"> |
| 66 | + :information_source: How to Run |
| 67 | +</h2> |
| 68 | + |
| 69 | +Follow the steps below to run the project in your machine, before it all, you need to have the Git, Node.js and Yarn installed on your computer, then follow the steps below: |
| 70 | + |
| 71 | +```bash |
| 72 | +# Clone the repo |
| 73 | +$ git clone https://github.com/TiagoDiass/github-ui-clone.git |
| 74 | + |
| 75 | +# Enter in the directory |
| 76 | +$ cd github-ui-clone |
| 77 | + |
| 78 | +# Install the dependencies |
| 79 | +$ yarn install |
| 80 | + |
| 81 | +# Start the app |
| 82 | +$ yarn start |
| 83 | +``` |
| 84 | + |
| 85 | +After following these steps, your browser will automatically open in `localhost:3000`. To stop the app just go back to the terminal and press <kbd>CTRL</kbd>+<kbd>C</kbd>. |
| 86 | + |
| 87 | +--- |
| 88 | + |
| 89 | +Hope you enjoyed this project :smiley:<br> |
| 90 | +:wave: [Get in touch!](https://www.linkedin.com/in/tiagodiass) |
| 91 | + |
| 92 | +### Author: Tiago Dias |
0 commit comments