diff --git a/Projects/2-Intermediate/GitHub-Profiles.md b/Projects/2-Intermediate/GitHub-Profiles.md new file mode 100644 index 00000000..505ead18 --- /dev/null +++ b/Projects/2-Intermediate/GitHub-Profiles.md @@ -0,0 +1,30 @@ +# GitHub Profiles +**Tier:** 2-Intermediate + +APIs allow you to use the real world data that drives platforms like GitHub. You can communicate with the remote servers and get data that you can use to build an app. + +In this project you create a search app that uses GitHub API to retrieve user information when a valid username is input. It should display avatar, username, followers count, repository count, top 4 repositories based on forks and stars. + +## User Stories + +- [ ] User can enter a username +- [ ] User can click on search button to retrieve information +- [ ] User can see the avatar, username, followers and repository count of searched user +- [ ] User can see the top 4 repositories of searched user +- [ ] User should get an alert if the username is not valid + +## Bonus features +- [ ] User can toggle dark/light mode +- [ ] Selected mode should persist when user comes back to the app again + +## Useful links and resources +To get the data you need to communicate with GitHub API. you can either + +- [Read Docs](https://developer.github.com/v3/) +- [Check API directly](https://api.github.com/users/chaharshivam) + +To get data from API you can check [fetch API](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API/Using_Fetch) in javascript + +## Example projects + +- [GitHub profiles](https://chaharshivam.github.io/github-profiles/?#) ([repo](https://github.com/chaharshivam/github-profiles)) diff --git a/README.md b/README.md index 97066c4f..025d856c 100644 --- a/README.md +++ b/README.md @@ -85,6 +85,7 @@ required to complete them. | [Emoji Translator App](./Projects/2-Intermediate/Emoji-Translator-App.md) | Translate sentences into Emoji | 2-Intermediate | | [Flashcards App](./Projects/2-Intermediate/FlashCards-App.md) | Review and test your knowledge through Flash Cards | 2-Intermediate | | [Flip Art App](./Projects/2-Intermediate/Flip-Art-App.md) | Animate a set of images | 2-Intermediate | +| [GitHub Profiles](./Projects/2-Intermediate/GitHub-Profiles.md) | A GitHub user seach App | 2-Intermediate | | [HighStriker Game](./Projects/2-Intermediate/HighStriker-Game.md) | Highstriker strongman carnival game | 2-Intermediate | | [Markdown Previewer](./Projects/2-Intermediate/Markdown-Previewer.md) | Preview text formatted in GitHub flavored markdown | 2-Intermediate | | [Markdown Table Generator](./Projects/2-Intermediate/Markdown-Table-Generator.md) | Convert a table into Markdown-formatted text | 2-Intermediate |