Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/armcha/Ribble

Simple Dribbble Client using Dribbble API, fully written in Kotlin 😱 ❤️
https://github.com/armcha/Ribble

android architecture-components clean-architecture dagger2 dribble kotlin mvp rxjava2

Last synced: about 2 months ago
JSON representation

Simple Dribbble Client using Dribbble API, fully written in Kotlin 😱 ❤️

Host: GitHub
URL: https://github.com/armcha/Ribble
Owner: armcha
License: other
Created: 2017-07-29T06:46:26.000Z (about 7 years ago)
Default Branch: master
Last Pushed: 2017-11-14T07:16:13.000Z (almost 7 years ago)
Last Synced: 2024-06-05T09:33:05.378Z (4 months ago)
Topics: android, architecture-components, clean-architecture, dagger2, dribble, kotlin, mvp, rxjava2
Language: Kotlin
Homepage:
Size: 12.6 MB
Stars: 867
Watchers: 28
Forks: 120
Open Issues: 6
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-kotlin - Ribble - Simple Dribbble Client using Dribbble API, fully written in Kotlin 😱 ❤️ (Libraries)
awesome-kotlin-android - Ribble - Dribbble客户端🔥🔥🔥 (完整 app / 测试)

README

        # Ribble



    

        

    



## Simple Dribbble Client using Dribbble API, work in progress...

## Features

:white_check_mark:  Kotlin: Yes, fully written in Kotlin(~96%). :scream: :heart: 


:white_check_mark:  Clean architecture: The whole project is based on uncle Bob's clean architecture approach. 


:white_check_mark:  Configuration change: Handles configuration changes 


:white_check_mark:  Material Design: Not a fully Material Design App, but I am trying my best. 


:white_check_mark:  Some custom views: Progress bar, navigation view, arcView, dialog...


:white_check_mark:  Usage of libraries:


   * [BaseMVP](https://github.com/armcha/MVP-Architecture-Components) - for MVP architecture


   * [Dagger 2](https://github.com/google/dagger) - for dependency injection


   * [RxJava 2, RxAndroid 2](https://github.com/ReactiveX/RxJava) - for data manipulation


   * [Architecture components](https://developer.android.com/topic/libraries/architecture/index.html) - ViewModel and LifeCycle


   * [Glide](https://github.com/bumptech/glide) - for image loading


   * [Gson](https://github.com/google/gson) - for serialization and deserialization


   * [Retrofit](https://github.com/square/retrofit) - for HTTP requests


   * [Room](https://developer.android.com/topic/libraries/architecture/room.html) - for data persistence (Not implemented yet)


   * [Leak canary](https://github.com/square/leakcanary) - for memory leak detection


   * [Logger](https://github.com/armcha/logger) - for simple logging


    

## TODO list:

:white_large_square: Adding/removing favourite shot 


:white_large_square: User profile screen 


:white_large_square: Data base for offline usage 


:white_large_square: Fonts 


:white_large_square: Endless scroll 


:white_large_square: Design improvements 


:white_large_square: Add unit tests & integration tests 
 

:white_large_square: More features using Dribbble API 


### Download sample [apk](https://github.com/armcha/Ribble/blob/master/art/Ribble.apk)

![Gif](art/ribble_demo.gif)

## Screenshots

| Login     | Popular/Recent     | Likes     |

| :-------------: | :-------------: | :-------------: |

| ![Login](art/log_in.png) | ![Popular/Recent](art/shots.png) | ![Likes](art/likes.png) |

| Shot detail     | Nav drawer     | App info     | 

| :-------------: | :-------------: | :-------------: |

| ![Shot detail](art/detail.png) | ![Nav drawer](art/nav_drawer.png) | ![App info](art/app_info.png) | 

    

## Build

### Open the project in Android Studio

```

git clone https://github.com/armcha/Ribble.git

```

### Dribbble OAuth

The App client id, client secret and client access token are placed in [gradle.properties](https://github.com/armcha/Ribble/blob/master/gradle.properties) file.


 **If the CLIENT SECRET and ACCESS TOKEN are abused, I will reset and not commit them**

 

 

## Contact

Pull requests are more than welcome.

- **Email**: [email protected]

- **Facebook**: https://web.facebook.com/chatikyana

- **Twitter**: https://twitter.com/ArmanChatikyan

- **Google +**: https://plus.google.com/+ArmanChatikyan

- **Website**: https://armcha.github.io/

- **Medium**: https://medium.com/@chatikyan

License

--------

      Simple Dribbble Client

      Copyright (c) 2017 Arman Chatikyan (https://github.com/armcha/Ribble).

      Licensed under the Apache License, Version 2.0 (the "License");

      you may not use this file except in compliance withLog 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.