Android/Kotlin codebase containing real world examples (CRUD, auth, advanced patterns, etc) that adheres to the RealWorld spec and API.

This codebase was created to demonstrate a fully fledged fullstack application built with Kotlin including CRUD operations, authentication, routing, pagination, and more.

See how a Medium.com clone (called Conduit) is built using Kotlin in Android to connect to any other backend from https://realworld.io/.

For more information on how to this works with other backends, head over to the RealWorld repo.

I've gone to great lengths to adhere to the latest community styleguides & best practices but had to adapt between the RealWorld specification and general mobile layout of Medium.com.

Development

This project has been developed with Android Studio

Concepts

This RealWorld app tries to show the following Android concepts:

100% Kotlin Codebase
MVVM (Model View ViewModel) Architecture
LiveData
Kotlin Coroutines
Jetpack Navigation Architecture

Architecture

The project follows the general MVVM structure without any specifics.

There are two modules in the project

app - The UI of the app. The main project that forms the APK
api - The REST API consumption library. Pure JVM library not Android-specific

Other Backends

Obviously, this RealWorld app is a frontend app. But it can connect to all backends implementing the RealWorld spec and API. To test you own backend implementation just change the URL in the settings dialog.

Testing

This project has been manually tested against

Emulator
- Pixel 2 Android SDK 23
Devices
- Samsung S8 Android 8.0.0

Automated tests

The project contains an example e2e test to illustrate an end-to-end test case.

License & Credits

Credits have to go out to Thinkster with their awesome RealWorld

This project is licensed under the MIT license.

Disclaimer

This source and the whole package comes without warranty. It may or may not harm your computer or cell phone. Please use with care. Any damage cannot be related back to the author. The source has been tested on a virtual environment and scanned for viruses and has passed all tests.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!