airbnb/epoxy

Features

• RecyclerView Screen Builders - Generates model classes from annotated custom views, databinding layouts, or view holders to define RecyclerView screens.
• Auto-Generated RecyclerView Models - Automatically creates RecyclerView adapter models from annotated custom views, data binding layouts, or view holders.
• RecyclerView Screen Composition - Builds complex scrolling screens in Android with multiple item types, grid layouts, and nested carousels using a declarative model-based approach.
• RecyclerView Model Lists - Manages lists of models that define items and their order in a RecyclerView with change notifications.
• Controller Adapter Integrators - Attaches a controller's adapter to a RecyclerView and triggers model builds when data changes.
• Controller Attachments - Connects an EpoxyController to a RecyclerView via its adapter or EpoxyRecyclerView for simplified setup.
• RecyclerView List Differs - Automatically diffs model lists and applies minimal updates with animations for insertions, removals, and moves.
• Model-Driven View Holders - Uses annotated abstract model classes and KotlinHolders to cache view lookups and generate equals/hashcode for diffing.
• RecyclerView Model Identifiers - Assigns unique identifiers to RecyclerView models for stable diffing and view state persistence.
• Model Property Change Detectors - Rebinds only changed properties using equals and hashcode comparisons for efficient updates.
• RecyclerView View State Persistence - Saves and restores RecyclerView item visual state across configuration changes.
• Model Variable Change Detection - Provides automatic detection of data variable changes to rebind only modified properties in RecyclerView items.
• List Update Optimizers - Compares old and new model lists to determine minimal changes and applies smooth animations.
• Typed Controller Data Passing - Provides typed controllers that receive data objects directly, enabling pure and testable model building.
• DataBinding Layout Model Generators - Generates RecyclerView model classes from Android DataBinding layouts using layout variables as properties.
• ViewHolder Model Generators - Generates RecyclerView model classes from view holder patterns using field annotations.
• Declarative Model Builders - Uses a controller class with a buildModels method to declaratively construct immutable model lists.
• RecyclerView Model Diffing - Compares RecyclerView model states using equals and hashCode to update only the views that changed.
• RecyclerView Model Rebuild Triggers - Provides a requestModelBuild method to trigger debounced model list rebuilds and adapter updates.
• Annotation-Driven View Bindings - Binds data to custom views via annotated setter methods with automatic prop assignment.
• Generated Setter Bindings - Binds model properties to views through generated setter methods with automatic resource handling.
• Controller-Based Model Builders - Subclasses the controller and implements buildModels to create immutable model instances for the RecyclerView.
• RecyclerView Change Notifications - Dispatches standard RecyclerView notifications after modifying the model list to keep the displayed view in sync.
• RecyclerView Model Generators - Generates RecyclerView adapter models at compile time from annotated views, layouts, or view holders.
• Controller Attachments - Provides a one-call method to attach an EpoxyController to a RecyclerView and trigger the first model build.
• RecyclerView Model Generators - Generates RecyclerView model classes from custom views, data binding layouts, or view holders using annotation processing.
• Data-Driven Model Builders - Builds immutable models from data state and diffs them against previous models for efficient updates.
• Selective Property Rebinders - Updates only changed properties when a model's state is updated, avoiding full view rebinds.
• List Diffing Dispatchers - Offloads RecyclerView model list diff computation to a background thread for UI responsiveness.
• RecyclerView - Automatically diffs model lists and applies minimal updates with animations for insertions, removals, and moves.
• ViewHolder Model Generators - Generates RecyclerView model classes from annotated abstract classes with view binding in holders.
• Selective Property Rebinders - Compares prop values and only calls setters for properties that changed, avoiding unnecessary view updates.
• RecyclerView Model Usage Validations - Adds runtime validation to prevent duplicate model additions and post-addition modifications in controllers.
• Runtime Immutability Enforcements - Enforces runtime immutability and unique ID checks on generated models to prevent state corruption.
• Model Building Thread Offloaders - Builds and diffs item models on a background thread to keep the UI responsive during pagination.
• Typed Controller Data Flow - Provides TypedEpoxyController for passing typed data directly to buildModels, reducing boilerplate.
• RecyclerView Carousels - Embeds horizontal carousels as models within parent vertical RecyclerViews with automatic view pool sharing.
• Layout-Based Model Generators - Generates RecyclerView model classes automatically from Android DataBinding layout files.
• Generated Model Base Classes - Defines a shared base class for generated models to reuse attributes and binding logic.
• RecyclerView Item Declarers - Defines which items to display in a RecyclerView by adding models in a build method with automatic rebuilds.
• DataBinding Variable Bindings - Binds Android DataBinding layout variables by matching EpoxyAttribute fields to variable names.
• Hydration-Stable Identifiers - Assigns stable identifiers to RecyclerView models for automatic diffing and view state persistence.
• RecyclerView Diff Identifiers - Compares model lists using equals and hashCode on stable identifiers for minimal RecyclerView updates.
• RecyclerView Model Identifiers - Assigns stable identifiers to RecyclerView models for automatic diffing and view state persistence.
• DataBinding Layout Model Generators - Generates RecyclerView model classes from declared DataBinding layouts using layout names.
• List Transition Animations - Automatically diffs state changes and applies animations for item additions, removals, and reorders.
• RecyclerView DSL Builders - Uses extension functions to declare RecyclerView items in a declarative Kotlin block, removing the need for a separate controller class.
• Carousel Snap Behaviors - Attaches a snap helper to align carousel items cleanly when scrolling stops, with customization options.
• RecyclerView Carousels - Creates a horizontally scrolling RecyclerView with built-in peeking, snapping, and performance optimizations for nested or top-level use.
• Annotation-Driven Model Generators - Generates RecyclerView model classes from annotated custom views, automating view creation and property binding.
• RecyclerView Model Generators - Generates RecyclerView adapter models from annotated custom views, eliminating manual view holder boilerplate.
• Recycle Lifecycle Cleanups - Provides annotation-based cleanup callbacks to release resources when views are recycled.
• Nullable Prop Auto-Clears - Automatically clears nullable properties on view recycle to prevent memory leaks.
• Recycle-Scoped State Persistence - Preserves view state across recycle and rebind cycles, maintaining user modifications during scroll.
• Model-Driven View Binding - Binds model properties to RecyclerView items when they scroll into view and releases resources on recycle.
• RecyclerView Model Annotations - Generates RecyclerView models from annotated custom views or view holders, automating equals/hashcode and binding.
• Model Group Root Access - Retrieves the parent view that contains all submodel views through the holder's getRootView() method during bind or unbind.
• Litho-View Combinations - Allows Litho components and traditional Android views to be used together in the same RecyclerView via an EpoxyController.
• Preloading - Fetches image data in the background before a model is bound to the screen.
• Glide Image Preloaders - Ships a built-in Glide preloader that matches image dimensions and scale type for cache hits.
• Mixed Paginated and Custom Items - Adds non-paged view types like headers alongside paginated items, rebuilding only custom models on demand.
• Auto-Managed Persistent Models - Annotates fields to automatically create and manage models with stable IDs for persistent items.
• RecyclerView Pagination - Loads large data sets page by page and constructs models on background threads to keep the UI responsive.
• Annotation-Free Model Definitions - Creates RecyclerView models using Kotlin data classes and property delegates without annotation processing.
• RecyclerView State Persistence - Saves and restores visual state of RecyclerView items across configuration changes, scrolls, and list updates.
• Per-View State Persistence - Activates view state saving on individual models, saving hierarchy state on unbind and restoring on initial bind.
• Paginated Item Mixins - Allows mixing paginated items with custom view types like headers in a single RecyclerView.
• Kotlin DSL Model Groups - Provides a Kotlin DSL extension function for building and adding grouped models within an EpoxyController.
• Mutually Exclusive Prop Groups - Groups setters so only the last-set prop is applied, preventing conflicting values on views.
• RecyclerView State Persistence - Saves and restores view state across activity or fragment recreation by calling save and restore methods on the controller.
• Model Visibility Override Callbacks - Overrides visibility callbacks in model subclasses to handle scroll events for all models of that type.
• Litho-View Combinations - Allows Litho components and traditional Android views to coexist in the same RecyclerView via EpoxyController.
• Grid Span Adaptations - Provides automatic grid span adjustment for phone, tablet, and wide tablet screens.
• Android String - Accepts Android string resource IDs and plurals for text properties via generated methods.
• Kotlin Property Delegates - Uses Kotlin property delegates to cache view lookups and simplify binding logic in RecyclerView models.
• View-Recycling Cancellations - Calls annotated methods when a view is recycled to release listeners and bitmaps.
• RecyclerView Model DSL Builders - Uses generated extension functions on the controller to create and add models in a concise lambda syntax.
• Visibility Annotation Handlers - Annotates view methods to receive scroll visibility state and percentage-visible events.
• RecyclerView Data Classes - Creates RecyclerView models using Kotlin data classes with built-in equals/hashcode for automatic diffing.
• Generated View Interfaces - Generates interfaces from shared view props for type-safe polymorphic model access.
• Adapter Observer Leak Preventers - Prevents memory leaks by removing adapter observers when RecyclerView is detached.
• Adapter Reuse Leak Preventers - Prevents memory leaks from reused adapters by recycling views on RecyclerView detachment.
• RecyclerView Adapter Leak Preventers - Prevents memory leaks by unregistering adapter observers on RecyclerView detachment.
• RecyclerView View Leak Preventers - Prevents memory leaks by recycling child views when RecyclerView is detached.
• Model Property Defaults - Makes model properties optional with default values via Kotlin defaults or annotations.
• Paging Library Data Loading - Loads large data sets page by page using the Android Paging Library, automatically building and caching models.
• Model List Interceptors - Ships an interceptor system for modifying the model list after build, enabling cross-cutting UI changes.
• Prop Change Exclusion Annotations - Excludes specific properties from triggering view updates via annotation, useful for listeners.
• Android Resource String Overloads - Generates convenience methods for setting text via Android string resources and plurals.
• Kotlin DSL Carousel Builders - Ships Kotlin extension functions for declaratively building carousel models within controllers.
• Custom Carousel Subclassing - Allows subclassing carousels to change layout direction, grid columns, sizing, or other behavior.
• Visible Item Count Configurators - Controls how many carousel items are displayed at once to adjust the layout density and peeking effect.
• Model Click Listeners - Attaches a typed click listener to a model that provides the model, view, clicked view, and position on click.
• Change Payload Animations - Passes change payloads to model bind methods for animating only the properties that changed.
• Content Prefetching - Kicks off background fetches for image content before a model is bound to the view.
• Litho Model Generations - Automatically creates EpoxyModel subclasses for Litho @LayoutSpec classes, adding setters for each @Prop and tracking prop state changes.
• Generated View Interfaces - Generates interfaces from view annotations for polymorphic model grouping and type-safe access.
• Carousel Peek Padding Configurators - Sets horizontal padding with clip-to-padding disabled so adjacent items partially peek from the edges to indicate scrollable content.
• RecyclerView Drag Reorderers - Enables rearranging list items via long-press drag, automatically updating the controller and notifying the RecyclerView of the move.
• Cell Column Spanning - Controls how many grid columns an item occupies by overriding span size per model.
• Dynamic Span Overrides - Computes span size dynamically via callbacks based on total span count and position.
• Per-Item Span Overrides - Computes span size per item via callbacks based on position and screen dimensions.
• Span Size Assignments - Assigns per-item span sizes in a GridLayoutManager for variable-width grid items.
• Post-Bind Property Coordination - Runs coordination logic after all properties are bound to synchronize multiple values before UI update.
• Cyclic Scrolling Patterns - Implements cyclic scrolling that repeats items endlessly for infinite carousel effects.
• Carousel Item Count Configurators - Specifies how many items appear at once in the carousel, adjusting view size and prefetch count for performance.
• Model Group Layouts - Groups multiple independent models into a single layout container using an XML layout resource.
• Partial Property Updates - Passes change payloads to bound views so they can animate or update only the parts that changed.
• Scroll Observers - Notifies callbacks when items scroll on or off screen, tracking visible, invisible, and focused states.
• RecyclerView Scroll State Persistence - Preserves each view's user-modified state, such as scroll position, when it scrolls off screen and back.
• Configuration Change Scroll Restorers - Restores scroll position of nested carousels and lists after data updates or configuration changes.
• List Item Swipe-to-Dismiss - Allows swiping items left or right to remove them, requiring a callback to update the underlying data and trigger a model rebuild.
• Litho Model Generations - Automatically creates EpoxyModel subclasses from Litho @LayoutSpec annotations with setters for each @Prop and change tracking.
• RecycledViewPool Sharing - Shares a single RecycledViewPool across multiple RecyclerView instances to maximize view recycling.
• Stale-Proof Click Handlers - Provides click listeners that always deliver the current model data, avoiding stale references from recycled views.
• Visibility Reporters - Reports scroll visibility state and percentage-visible events for items through annotations and listeners.
• RecyclerView Item - Toggles item visibility in RecyclerView without removal, using an empty zero-height layout.
• Auto-Model Persistent Items - Provides @AutoModel annotation for automatic creation and stable ID assignment of persistent RecyclerView items.
• Per-Instance Visibility Listeners - Attaches visibility state and percentage-visible listeners to individual model instances.
• Item Click Delegators - Attaches typed click listeners to models, providing the model, view, and position on click.
• RecyclerView Model Build Offloaders - Configures custom Handler threads for model building and diffing to offload work from the main thread.
• UI Components - Building complex screens in RecyclerView.

Star history