{"id":13507328,"url":"https://github.com/Comcast/FreeFlow","last_synced_at":"2025-03-30T07:32:53.594Z","repository":{"id":11076169,"uuid":"13421516","full_name":"Comcast/FreeFlow","owner":"Comcast","description":"A layout engine for Android that decouples layouts from the View containers that manage scrolling and view recycling. FreeFlow makes it really easy to create custom layouts and beautiful transition animations as data and layouts change","archived":true,"fork":false,"pushed_at":"2018-11-01T17:58:32.000Z","size":2117,"stargazers_count":2397,"open_issues_count":33,"forks_count":394,"subscribers_count":148,"default_branch":"master","last_synced_at":"2024-08-02T02:11:15.519Z","etag":null,"topics":[],"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/Comcast.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-10-08T18:13:33.000Z","updated_at":"2024-06-27T13:01:34.000Z","dependencies_parsed_at":"2022-07-09T23:30:23.256Z","dependency_job_id":null,"html_url":"https://github.com/Comcast/FreeFlow","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Comcast%2FFreeFlow","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Comcast%2FFreeFlow/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Comcast%2FFreeFlow/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Comcast%2FFreeFlow/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Comcast","download_url":"https://codeload.github.com/Comcast/FreeFlow/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":222535179,"owners_count":16999233,"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":[],"created_at":"2024-08-01T02:00:31.257Z","updated_at":"2024-11-01T06:31:48.154Z","avatar_url":"https://github.com/Comcast.png","language":"Java","readme":"FreeFlow is no longer under development\n=======================================\n\nWe are no longer working on FreeFlow and have moved to RecyclerViews for similar functionality. \nThanks for all your support and interest\n-Arpit Mathur\n\n\nFreeFlow\n========\n\nA layout engine for Android that decouples layouts from the View containers that manage scrolling and view recycling. FreeFlow makes it really easy to create custom layouts and beautiful transition animations as layouts are changed.\n\nFreeFlow is a composition based approach to Android Layouts. As opposed to default Android Layouts, FreeFlow Layouts are swappable at runtime which allows views to their new states smoothly. The fundamental difference here is that FreeFlow prefers [Composition over Inheritance](http://en.wikipedia.org/wiki/Composition_over_inheritance) which makes the system a lot more adaptable.\n\nFreeflow may be considered in \"alpha\". You can help in many ways, by reviewing and making suggestions on api's to actually finding bugs and submitting patches via pull requests.\n\nFreeFlow is inspired by UI frameworks like [UICollectionViews on iOS][1] and the [Spark Architecture in Flex][2]. \n\n\n![](https://raw.github.com/Comcast/FreeFlow/master/examples/Artbook/screenshots/freeflow.png)\n\n# Building Blocks\n\nAt the basic level, FreeFlow consists of 4 parts:\n\n* [FreeFlowContainer][3]: The core class that extends ViewGroup and places all Views inside it\n* [FreeFlowLayout][4]: The class thats responsible for defining the [Rect](5)'s that the Container will use to position the Views.\n* [FreeFlowLayoutAnimator][6]: The animator that will animate the Views when their position Rect's are changed because of a change in the Layout\n* [SectionedAdapter][7]: The data adapter class that returns the View instances based on the data being rendered. Its modeled very closely to the List Adapters that are used in Android but also understand the concept of \"[Section][8]\" which might segment data into different parts (For example a user's contacts list may include Sections that hold names beginning with a particular character). \n\nAdditionally there are some helper classes like the [DefaultLayoutAnimator][9] that will transition views automatically as they get added, moved or removed and is pretty configurable. FreeFlow comes with some basic Layouts like HLayout, VLayout , HGridLayout and VGridLayout but its easy enough to create custom layouts (see the [Artbook example's custom layout][10])\n\n\nThe Artbook example in this repository is a good example of whats possible with FreeFlow. You can download the .apk from the releases tab or see the experience on the video below: \n\n[![Artbook demo project](http://img.youtube.com/vi/xDd-bcGqLkw/0.jpg)][11]\n\n# Feedback/Support/Help\n\nJoin the [Google+ community][12] for questions or keeping up with upcoming features, releases, etc\n\nIf you have changes you'd like to commit to the repo, you will need to sign the [Comcast Contributor License Agreement](Comcast Contributor License Agreement (03-07-14).pdf) available at the root of this repository.\n\n\n\n[1]: https://developer.apple.com/library/ios/documentation/UIKit/Reference/UICollectionView_class/Reference/Reference.html\n[2]: http://www.adobe.com/devnet/flex/articles/flex4_sparkintro.html\n[3]: FreeFlow/src/com/comcast/freeflow/core/FreeFlowContainer.java\n[4]: FreeFlow/src/com/comcast/freeflow/layouts/FreeFlowLayout.java\n[5]: http://developer.android.com/reference/android/graphics/Rect.html\n[6]: FreeFlow/src/com/comcast/freeflow/animations/FreeFlowLayoutAnimator.java\n[7]: FreeFlow/src/com/comcast/freeflow/core/SectionedAdapter.java\n[8]: FreeFlow/src/com/comcast/freeflow/core/Section.java\n[9]: FreeFlow/src/com/comcast/freeflow/animations/DefaultLayoutAnimator.java\n[10]: examples/Artbook/src/com/comcast/freeflow/examples/artbook/layouts/ArtbookLayout.java\n[11]: http://www.youtube.com/watch?v=xDd-bcGqLkw\n[12]: https://plus.google.com/communities/109232474194967955567\n","funding_links":[],"categories":["Index `(light-weight pages)`","Java","Libs","etc"],"sub_categories":["\u003cA NAME=\"Widget\"\u003e\u003c/A\u003eWidget"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FComcast%2FFreeFlow","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FComcast%2FFreeFlow","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FComcast%2FFreeFlow/lists"}