{"id":17056277,"url":"https://github.com/rubensousa/dpadrecyclerview","last_synced_at":"2026-02-19T23:04:23.879Z","repository":{"id":62664011,"uuid":"530412665","full_name":"rubensousa/DpadRecyclerView","owner":"rubensousa","description":"A RecyclerView built for Android TV with Compose in mind and as a replacement for Leanback's BaseGridView.","archived":false,"fork":false,"pushed_at":"2025-07-05T20:48:45.000Z","size":9369,"stargazers_count":154,"open_issues_count":1,"forks_count":19,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-07-05T21:35:38.794Z","etag":null,"topics":["android","android-tv","leanback","recyclerview"],"latest_commit_sha":null,"homepage":"https://rubensousa.github.io/DpadRecyclerView/","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rubensousa.png","metadata":{"files":{"readme":"README.MD","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"rubensousa"}},"created_at":"2022-08-29T22:21:06.000Z","updated_at":"2025-07-05T20:48:48.000Z","dependencies_parsed_at":"2023-02-16T18:46:23.984Z","dependency_job_id":"d509ecd5-671e-4da9-8a58-cbade2125c7b","html_url":"https://github.com/rubensousa/DpadRecyclerView","commit_stats":null,"previous_names":[],"tags_count":50,"template":false,"template_full_name":null,"purl":"pkg:github/rubensousa/DpadRecyclerView","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rubensousa%2FDpadRecyclerView","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rubensousa%2FDpadRecyclerView/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rubensousa%2FDpadRecyclerView/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rubensousa%2FDpadRecyclerView/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rubensousa","download_url":"https://codeload.github.com/rubensousa/DpadRecyclerView/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rubensousa%2FDpadRecyclerView/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29632904,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-19T18:02:07.722Z","status":"ssl_error","status_checked_at":"2026-02-19T18:01:46.144Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","android-tv","leanback","recyclerview"],"created_at":"2024-10-14T10:23:54.362Z","updated_at":"2026-02-19T23:04:23.866Z","avatar_url":"https://github.com/rubensousa.png","language":"Kotlin","funding_links":["https://github.com/sponsors/rubensousa"],"categories":[],"sub_categories":[],"readme":"# DpadRecyclerView\n\nA RecyclerView built for Android TV as a replacement for [Leanback's](https://developer.android.com/jetpack/androidx/releases/leanback) BaseGridView.\n\nSee the project website for more information: https://rubensousa.github.io/DpadRecyclerView\n\nSample available on Google Play: https://play.google.com/store/apps/details?id=com.rubensousa.dpadrecyclerview.sample\n\nWhy should you use this library?\n\n1. Leanback hasn't received any significant update for years\n2. Compose support for TV is still in its early stages\n3. RecyclerView is stable and works well with Compose\n4. You need to maintain an existing TV app and wish to introduce Compose in an incremental way\n5. Contains useful Espresso testing helpers for your TV UI tests\n6. More feature complete:\n\n| Feature                          | DpadRecyclerView | Leanback | Compose TV |\n|----------------------------------|------------------|----------|------------|\n| Custom scrolling speeds          | ✅                | ✅        | ❌          |\n| Edge alignment preference        | ✅                | ✅        | ❌          |\n| Sub position selections          | ✅                | ✅        | ❌          |\n| Fading edges                     | ✅                | ✅        | ❌          |\n| Alignment listener               | ✅                | ✅        | ❌          |\n| Grids with uneven span sizes     | ✅                | ❌        | ✅          |\n| Extra layout space               | ✅                | ❌        | ✅          |\n| Prefetching upcoming items       | ✅                | ❌        | ✅          |\n| Reverse layout                   | ✅                | ❌        | ✅          |\n| Testing library                  | ✅                | ❌        | ✅          |\n| Scrollbars                       | ✅                | ❌        | ❌          |\n| Drag and Drop                    | ✅                | ❌        | ❌          |\n| Infinite layout with loop        | ✅                | ❌        | ❌          |\n| Smooth alignment changes         | ✅                | ❌        | ❌          |\n| Child focus observer             | ✅                | ❌        | ❌          |\n| Circular and continuous focus    | ✅                | ❌        | ❌          |\n| Throttling scroll events         | ✅                | ❌        | ❌          |\n| Scrolling without animation      | ✅                | ❌        | ❌          |\n| Scrolling in secondary directory | ❌                | ✅        | ❌          |\n\n\nBackground story for this library is available in my [blog](https://rubensousa.com/2022/11/08/dpadrecyclerview/) in case you're interested.\n\nCheck the sample app for a complete example of integration of this library\n\n\n![sample](https://github.com/rubensousa/DpadRecyclerView/blob/master/assets/sample_cover.png?raw=true)\n\n## Getting started\n\nAdd the following dependency to your app's `build.gradle`:\n\n```groovy\nimplementation \"com.rubensousa.dpadrecyclerview:dpadrecyclerview:$latestVersion\"\n\n// Recommended: To use Compose together with DpadRecyclerView\nimplementation \"com.rubensousa.dpadrecyclerview:dpadrecyclerview-compose:$latestVersion\"\n\n// Optional: Espresso test helpers for your instrumented tests:\nandroidTestImplementation \"com.rubensousa.dpadrecyclerview:dpadrecyclerview-testing:$latestVersion\"\n```\n\nCheck the official website for more information and recipes: https://rubensousa.github.io/DpadRecyclerView\n\n## Easier Compose Integration\n\nDocumentation: https://rubensousa.github.io/DpadRecyclerView/compose/\n\n```kotlin\nclass ComposeItemAdapter(\n    private val onItemClick: (Int) -\u003e Unit\n) : ListAdapter\u003cInt, DpadComposeFocusViewHolder\u003cInt\u003e\u003e(Item.DIFF_CALLBACK) {\n\n    override fun onCreateViewHolder(\n        parent: ViewGroup,\n        viewType: Int\n    ): DpadComposeFocusViewHolder\u003cInt\u003e {\n        return DpadComposeFocusViewHolder(parent) { item -\u003e\n            ItemComposable(\n                item = item,\n                onClick = {\n                    onItemClick(item)\n                }\n            )\n        }\n    }\n\n    override fun onBindViewHolder(\n        holder: DpadComposeFocusViewHolder\u003cInt\u003e, \n        position: Int\n    ) {\n        holder.setItemState(getItem(position))\n    }\n    \n}\n```\n\n## Sample app\n\nNested lists:\n\n![nested_lists](https://github.com/rubensousa/DpadRecyclerView/blob/master/assets/sample_nested_lists.png?raw=true)\n\n[focus_overlay.webm](https://user-images.githubusercontent.com/10662096/219993088-c292de23-0c65-48fb-bde0-ea5ddf9b3bd4.webm)\n\nGrid with different span sizes:\n\n![grid](https://github.com/rubensousa/DpadRecyclerView/blob/master/assets/sample_grid.png?raw=true)\n\n\n## License\n\n    Copyright 2024 Rúben Sousa\n    \n    Licensed under the Apache License, Version 2.0 (the \"License\");\n    you may not use this file except in compliance with the License.\n    You may obtain a copy of the License at\n    \n        http://www.apache.org/licenses/LICENSE-2.0\n    \n    Unless required by applicable law or agreed to in writing, software\n    distributed under the License is distributed on an \"AS IS\" BASIS,\n    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n    See the License for the specific language governing permissions and\n    limitations under the License.\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frubensousa%2Fdpadrecyclerview","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frubensousa%2Fdpadrecyclerview","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frubensousa%2Fdpadrecyclerview/lists"}