{"id":19552019,"url":"https://github.com/helixform/fluidrecyclerview","last_synced_at":"2025-04-26T20:31:29.682Z","repository":{"id":195163162,"uuid":"686668287","full_name":"Helixform/FluidRecyclerView","owner":"Helixform","description":"Brings the iOS scrolling experience to Android.","archived":false,"fork":false,"pushed_at":"2023-09-16T13:50:28.000Z","size":864,"stargazers_count":131,"open_issues_count":0,"forks_count":5,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-04T17:51:45.122Z","etag":null,"topics":["android","animation","ios","kotlin","library","physics-simulation","recyclerview","spring"],"latest_commit_sha":null,"homepage":"","language":"Java","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/Helixform.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2023-09-03T15:02:41.000Z","updated_at":"2025-03-14T09:44:32.000Z","dependencies_parsed_at":null,"dependency_job_id":"e3df49e0-fa39-412e-93d9-a66201c2b73f","html_url":"https://github.com/Helixform/FluidRecyclerView","commit_stats":{"total_commits":31,"total_committers":2,"mean_commits":15.5,"dds":0.4838709677419355,"last_synced_commit":"daad65337010b79a9c8015a41f4b4d79ab8b25ad"},"previous_names":["helixform/fluidrecyclerview"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Helixform%2FFluidRecyclerView","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Helixform%2FFluidRecyclerView/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Helixform%2FFluidRecyclerView/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Helixform%2FFluidRecyclerView/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Helixform","download_url":"https://codeload.github.com/Helixform/FluidRecyclerView/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251051413,"owners_count":21528787,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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","animation","ios","kotlin","library","physics-simulation","recyclerview","spring"],"created_at":"2024-11-11T04:16:21.000Z","updated_at":"2025-04-26T20:31:25.119Z","avatar_url":"https://github.com/Helixform.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FluidRecyclerView\n\nBrings the iOS scrolling experience to Android.\n\n## Introduction\n\n`FluidRecyclerView` is a fork version of `RecyclerView` from Android Jetpack, which can reside with the original version side by side. It provides the same public APIs of `RecyclerView`, and you can use it without any code change.\n\nThe major differences from the original version:\n- Replaced the fling animation to match how it feels in iOS.\n- Added the rubber band effect.\n- Optimized the velocity calculation algorithm.\n\nThis library takes code from [fluid-scroll](https://github.com/ktiays/fluid-scroll), which ports many important algorithms like spring simulation, velocity calculation, etc. Check it out if you are looking for implementations for other platforms.\n\n📽️ Let's see it in action:\n\nhttps://github.com/ktiays/fluid-scroll/assets/44366293/0d4c988f-8258-4966-8dda-92121b8db3de\n\n## Getting Started\n\nTo use `FluidRecyclerView` in your project, add the JitPack repository to your `settings.gradle.kts` file:\n\n```kotlin\ndependencyResolutionManagement {\n    repositories {\n        // ...\n        maven {\n            url = URI(\"https://jitpack.io\")\n        }\n    }\n}\n```\n\nThen, add the dependency:\n\n```kotlin\ndependencies {\n    // ...\n    implementation(\"com.github.Helixform:FluidRecyclerView:main-SNAPSHOT\")\n}\n```\n\nNow replace all the packages of `RecyclerView` and related classes with `androidx.fluidrecyclerview.widget.*`:\n\n```patch\n- import androidx.recyclerview.widget.RecyclerView\n- import androidx.recyclerview.widget.RecyclerView.Adapter\n- import androidx.recyclerview.widget.RecyclerView.ViewHolder\n+ import androidx.fluidrecyclerview.widget.RecyclerView\n+ import androidx.fluidrecyclerview.widget.RecyclerView.Adapter\n+ import androidx.fluidrecyclerview.widget.RecyclerView.ViewHolder\n```\n\nThat's it!\n\n## FAQ\n\n### Which version of RecyclerView is this library based on?\n\nThe library is forked from `androidx.recyclerview:recyclerview:1.3.1` ([commit](https://android.googlesource.com/platform/frameworks/support/+/68f4660cd40b87c9383c5c7d86ae26ebccbf93e8)), and currently have no plans to synchronize with higher versions.\n\n### Is there any public API changes?\n\nNo. But note that some internal methods \u0026 classes have been changed or removed. If you are using some private APIs via reflection, your app may behave abnormally.\n\n### Why is it still using `androidx` package name?\n\nThe library uses some package-visible APIs from other AndroidX components. To reduce unnecessary modifications and impacts of using this library, we just renamed the child packages.\n\n### Can I change the scrolling behavior dynamically?\n\nIt's not supported currently. Since this library can coexist with the original `RecyclerView`, you can implement that feature at app level.\n\n## License\n\n```\nCopyright 2018 The Android Open Source Project\nCopyright (C) 2023 Helixform\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n     http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhelixform%2Ffluidrecyclerview","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhelixform%2Ffluidrecyclerview","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhelixform%2Ffluidrecyclerview/lists"}