Develop a native application, Android or iOS, which will allow the user to search and display a GitHub profile. Including the profile name, photo, repositories and their programming languages.
The API for making calls is available at the following URL: https://api.github.com/users/[username]/repos
- Home screen: Composed of a text box, where the profile name should be entered, and a button to perform the search, whose result should be displayed in the profile detail screen.
- Profile detail: This screen should display the profile name and photo (if it is found) and a list with all its the repositories. This list should present the name of the repository and, in the subtitle of each item, its programming language. A back button should allow you to return to the home screen to perform a new search.
- Error handling: When any error occurs in the API call, the following message should be displayed: "A network error has occurred. Check your Internet connection and try again later.". This message should have an "OK" button that just closes it.
- User not found: If a user is not found, display the following message: "User not found. Please enter another name.". This message should have an "OK" button that just closes it.
- The application should be developed using the native tools, Android Studio + Kotlin.
- Follow as closely as possible the reference layout provided in this document.
- Layout should fit any screen size, including tablet. For this it is enough to maintain the alignment of the elements.
- You can use any library to build the application, Retrofit, Picasso and etc.
In addition to the implementation of all functionalities and requirements, the following aspects of the solution will be taken into account:
- Clarity and organization of the code and files.
- Testability.
- Maintainability.
- Performance.
- It is expected a "production level" quality, something you consider good enough to release in production.
The idea is complete this challenge on a couple of afternoons more or less. In this project you will see:
Clean Architecture with MVP
Kodein for DI
Coroutines for network requests
Either instead of exceptions
Animations using MotionLayout and MotionScene
Kotlin extensions for views, activities, images, etc.
BetterAdapter to draw list items
Unit testing for presenter and repository
New branches:
mvp-new-way uses another way to implement the repository and datasources. Also, the new retrofit version 2.6.0 is used to add suspend functions and remove Deferred calls.
mvp-room-database uses Room database to implement the local datasource. Also, I use LiveData with Either.
master-new-list-adapter refactor RecyclerView.Adapter to use ListAdapter with AsyncListDiffer.
Jaime GC
- Karumi for their amazing GitHub repos
- 47 Degrees because I ❤️ Either and Arrow
Copyright 2019 Jaime GC
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.