Code Monkey home page Code Monkey logo

github_browser's Introduction

GitHub Browser

Features

Simple GitHub user and repository browser.

The application is able to search for users and show their repositories with additional information.

After login, the user is landed on the user screen.

The user screen has avatar, username, number of followers and the number of people the user is following.

List of the user's and starred repositories.

The "Followers" and "Following" are clickable and when clicked on, open a list of corresponding users.

A search icon, on which when clicked, a user may filter the results.

When clicked on any repository item on the list, a repository screen opens.

It has contributors and owner button which navigate to appropriate screens.

Star/Unstar functionality is also included.

There is also bottom menu with "Home", "Search" and "Logout" items.

All data is cached on the device for offline access.

Screenshots

Login & GitHub oauth

Login Login oauth

Home & User profile

Home User profile

User own & starred repositories

User own repos User starred repos

User followers & following

User followers User following

Repository profile & contributors

Repository profile Repository contributors

Search & Search types

Search Search type

Search repositories & users

Search repositories Search users

Development Environment

The app is written entirely in Kotlin and uses the Gradle build system.

To build the app, use the gradlew build command or use "Import Project" in Android Studio. MinSdkVersion is 28.

Architecture

The architecture is built around Android Architecture Components.

Followed the recommendations laid out in the Guide to App Architecture when deciding on the architecture for the app. Logic is kept away from Activities and Fragments and moved to ViewModels. Observed data using LiveData and Data Binding Library to bind UI components in layouts to the app's data sources. Room is used for offline storage.

Repository layer is used for handling data operations. Data comes from a GitHub API and is fetched on the go. The repository modules are responsible for handling all data operations and abstracting the data sources from the rest of the app. (if we wanted to swap the API for a different data source in the future,
the architecture allows to do so in a clean way).

Implemented a lightweight domain layer, which sits between the data layer and the presentation layer, and handles discrete pieces of business logic off the UI thread. See the UseCase.kt files under /domain for examples.

Used Navigation component to simplify into a single Activity app.

Used Dagger2 for dependency injection and heavily relied on dagger-android to abstract away boiler-plate code.

github_browser's People

Contributors

ivzb avatar

Watchers

James Cloos avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.