Skip to content

gaelmarhic/RIBs

 
 

Repository files navigation

RIBs

Version Build Status License

Why should I care about this?

Practical implementation of ideas presented in this DroidconUK 19 talk:

The immense benefits of not thinking in screens

RIBs as a pattern

Single-activity approach

Your view hierarchy is already a tree - RIBs gives you a way to compose your application in a similar way.

Simplicity

Break down the complexity of your project into manageable chunks. Compose them together to create abstractions on higher levels. Different levels - same approach.

Cohesive, reusable modules

RIB = business logic + UI + all related functionality packaged together, hiding all implementation details.

Screen-agnostic modules

Use the same approach that works on any level of view-hierarchy:

  • sections of the screen
  • full-screen
  • multi-screen flows
  • pure business logic without any view

Reusability on steroids

Achieve bare minimum coupling: RIBs are not coupled to their parents or siblings, and are easy to move around. Just provide dependencies to a Builder, and you are ready to go.

Deep scope trees

Fine-grained control over object lifetimes. Want to go more specific than a single @Singleton and @Activity scope? RIBs tree lends a natural and easy way to do this.

Instumentation testing in isolation

RIBs can be tested in isolation even in instrumentation tests

RIBs as an implementation

Builders

Compile-time safety over runtime crashes: you construct RIBs yourself, and can leverage constructor dependency injection.

Remote control

Workflows allow you to chain operations of individual RIBs together. You can then trigger workflows from e.g.:

  • console
  • push notifications from deep links

Use it to easily move your app to specific states.

About Badoo's fork

Badoo RIBs is an evolution of Uber RIBs, with notable differences and additions

Addressing key issues

  • Tree structure is saved / restored automatically
  • Reduced boilerplate code for Router by using routing actions and declarative routing
  • Added back stack for routing with back stack operations (push, pop, replace, etc.)
  • Back stack is saved / restored automatically
  • Separated View lifecycle from logical Node lifecycle, which adds many new interesting possibilities (e.g. RIBs with business logic still alive in back stack, RIBs hosted in an AlertDialog)
  • Support for Android lifecycle events

Making it even smoother

  • Happily integrated with MVICore
  • Enjoy full support for state management with async loading, one-time events, time-travel debugging, and more. Check documentation for a full list features.
  • First-class support for unidirectional data-flow: one-liners for connecting endpoints
  • Providing customisations for RIBs
  • Template generator plugin compiled from live code templates
  • Kotlin

Roadmap to 1.0

See here

Tutorials

See here. Check back later for more, as only basic functionality is covered as of yet. In the meantime, you can also check out the app-example module.

WIP warning

This is an in-progress, preview version.

Bugs are probably less of an issue, as the framework is pretty well covered with unit tests, but API can change until 1.0.

About

Badoo's take on RIBs

Resources

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Kotlin 100.0%