{"id":15487263,"url":"https://github.com/blaugold/circular_clip_route","last_synced_at":"2025-07-16T18:05:08.427Z","repository":{"id":56827033,"uuid":"275835881","full_name":"blaugold/circular_clip_route","owner":"blaugold","description":"A Flutter package which provides a page route which reveals its page by expanding a circular clip.","archived":false,"fork":false,"pushed_at":"2022-06-12T23:31:48.000Z","size":22666,"stargazers_count":31,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-22T15:52:25.998Z","etag":null,"topics":["animation","circular","clip","flutter","page","route","transition","ui"],"latest_commit_sha":null,"homepage":"https://pub.dev/packages/circular_clip_route","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/blaugold.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":"blaugold"}},"created_at":"2020-06-29T14:16:34.000Z","updated_at":"2024-12-05T01:14:19.000Z","dependencies_parsed_at":"2022-09-20T22:11:59.172Z","dependency_job_id":null,"html_url":"https://github.com/blaugold/circular_clip_route","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/blaugold/circular_clip_route","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blaugold%2Fcircular_clip_route","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blaugold%2Fcircular_clip_route/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blaugold%2Fcircular_clip_route/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blaugold%2Fcircular_clip_route/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blaugold","download_url":"https://codeload.github.com/blaugold/circular_clip_route/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blaugold%2Fcircular_clip_route/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265528922,"owners_count":23782783,"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":["animation","circular","clip","flutter","page","route","transition","ui"],"created_at":"2024-10-02T06:21:54.141Z","updated_at":"2025-07-16T18:05:08.407Z","avatar_url":"https://github.com/blaugold.png","language":"Dart","funding_links":["https://github.com/sponsors/blaugold"],"categories":[],"sub_categories":[],"readme":"[![pub.dev package page](https://badgen.net/pub/v/circular_clip_route)](https://pub.dev/packages/circular_clip_route)\n[![GitHub Stars](https://badgen.net/github/stars/blaugold/circular_clip_route)](https://github.com/blaugold/circular_clip_route/stargazers)\n\nA page route, which reveals its page by expanding a circular clip from an anchor\nwidget.\n\n\u003cdiv align=center\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/blaugold/circular_clip_route/master/doc/example-screen-recording.gif\" height=\"500\"\u003e\n\u003c/div\u003e\n\n---\n\nIf you're looking for a **database solution**, check out\n[`cbl`](https://pub.dev/packages/cbl), another project of mine. It brings\nCouchbase Lite to **standalone Dart** and **Flutter**, with support for:\n\n- **Full-Text Search**,\n- **Expressive Queries**,\n- **Data Sync**,\n- **Change Notifications**\n\nand more.\n\n---\n\n# Getting started\n\nTo use the `CircularClipRoute`, provide it the context from which the animation\nshould expand and push it onto the navigation stack. One way to get the right\ncontext is to use a `Builder`, which wraps the widget from which the route\nshould expand:\n\n```dart\nfinal navigationTrigger = Builder(\n    builder: (context) {\n      return IconButton(\n          icon: Icon(Icons.favorite),\n          onPressed: () {\n            Navigator.push(context, CircularClipRoute\u003cvoid\u003e(\n              // This context will be used to determine the location and size of\n              // the expanding clip. Here this will resolve to the `IconButton`.\n              expandFrom: context,\n              builder: (_) =\u003e MyRoute(),\n            ));\n          }\n      );\n    }\n);\n```\n\nAlso, take a look at the API docs for customizing the animation.\n\n# Example\n\nThe [example] implements the demo at the top.\n\n# References\n\nInspired by\n[this shot](https://dribbble.com/shots/12132567-Personal-Challenge-App-Interactions).\n\nThis drawing visualizes the geometry involved in creating the route transition:\n\n\u003cdiv align=center\u003e\n  \u003cimg src=\"https://raw.githubusercontent.com/blaugold/circular_clip_route/master/doc/Geometry.svg\" width=\"600\" alt=\"Illustration of the geometry of the transition\"\u003e\n\u003c/div\u003e\n\nThe\n[Anchored Custom Routes](https://medium.com/flutter-community/anchored-custom-routes-b34e36121e65)\narticle explains how to implement routes, that are anchored to a widget,\ngenerally.\n\n---\n\n**Gabriel Terwesten** \u0026bullet; **GitHub**\n**[@blaugold](https://github.com/blaugold)** \u0026bullet; **Twitter**\n**[@GTerwesten](https://twitter.com/GTerwesten)** \u0026bullet; **Medium**\n**[@gabriel.terwesten](https://medium.com/@gabriel.terwesten)**\n\n[example]:\n  https://github.com/blaugold/circular_clip_route/blob/master/example/lib/contact_list_page.dart\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblaugold%2Fcircular_clip_route","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblaugold%2Fcircular_clip_route","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblaugold%2Fcircular_clip_route/lists"}