├── .DS_Store ├── mockup.png ├── row_explained.png └── README.md /.DS_Store: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/gemography/frontend-coding-challenge/HEAD/.DS_Store -------------------------------------------------------------------------------- /mockup.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/gemography/frontend-coding-challenge/HEAD/mockup.png -------------------------------------------------------------------------------- /row_explained.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/gemography/frontend-coding-challenge/HEAD/row_explained.png -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # Front-end Coding Challenge 2 | 3 | ## Idea of the App 4 | The task is to implement a small webapp that will list the most starred Github repos that were created in the last 30 days. 5 | You'll be fetching the sorted JSON data directly from the Github API (Github API explained down below). 6 | 7 | ## Features 8 | * As a User I should be able to list the most starred Github repos that were created in the last 30 days. 9 | * As a User I should see the results as a list. One repository per row. 10 | * As a User I should be able to see for each repo/row the following details : 11 | * Repository name 12 | * Repository description 13 | * Number of stars for the repo. 14 | * Number of issues for the repo. 15 | * Username and avatar of the owner. 16 | * As a User I should be able to keep scrolling and new results should appear (pagination). 17 | 18 | ## Things to keep in mind 🚨 19 | * Features are less important than code quality. Put more focus on code quality and less on speed and number of features implemented. 20 | * Your code will be evaluated based on: code structure, programming best practices, legibility (and not number of features implemented or speed). 21 | * The git commit history (and git commit messages) will be also evaluated. 22 | * Do not forget to include few details about the project in the README (e.g explain choice of libraries, how to run it ...) 23 | 24 | ## How to get the data from Github 25 | To get the most starred Github repos created in the last 30 days (relative to 2017-11-22), you'll need to call the following endpoint : 26 | 27 | `https://api.github.com/search/repositories?q=created:>2017-10-22&sort=stars&order=desc` 28 | 29 | The JSON data from Github will be paginated (you'll receive around 100 repos per JSON page). 30 | 31 | To get the 2nd page, you add `&page=2` to the end of your API request : 32 | 33 | `https://api.github.com/search/repositories?q=created:>2017-10-22&sort=stars&order=desc&page=2` 34 | 35 | To get the 3rd page, you add `&page=3` ... etc 36 | 37 | You can read more about the Github API over [here](https://developer.github.com/v3/search/#search-repositories 38 | ). 39 | 40 | ## Mockups 41 | ![alt text](https://raw.githubusercontent.com/hiddenfounders/frontend-coding-challenge/master/mockup.png) 42 | 43 | Here's what each element represents : 44 | 45 | ![alt text](https://raw.githubusercontent.com/hiddenfounders/frontend-coding-challenge/master/row_explained.png) 46 | 47 | ## Technologies to use 48 | Choose whatever front-end technology you're most familiar with. But here's some of the technologies our teams are familiar with: 49 | * React 50 | * Vue 51 | * Angular 52 | 53 | ## How to submit the challenge solution? 54 | Now after you finished your app and we assume that you already pushed it to your GitHub account, if so please follow the instructions below: 55 | 56 | 1. Set the Repo privacy: 57 | - If the repo is sensitive and you're not comfortable sharing it publicly please give access to this username: [salimbraksa](https://github.com/salimbraksa). 58 | - If it's public go to the next step 59 | 2. Send the repo's link to this email: `careers@gemography.com`. 60 | --------------------------------------------------------------------------------