{"id":16382747,"url":"https://github.com/creativecreatorormaybenot/performance","last_synced_at":"2025-03-21T01:32:40.516Z","repository":{"id":40559803,"uuid":"418205768","full_name":"creativecreatorormaybenot/performance","owner":"creativecreatorormaybenot","description":"Performance overlay for Flutter apps that works on web.","archived":false,"fork":false,"pushed_at":"2025-01-03T02:44:04.000Z","size":6647,"stargazers_count":30,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-01T01:41:38.614Z","etag":null,"topics":["dart","flutter","flutter-package","flutter-web"],"latest_commit_sha":null,"homepage":"","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/creativecreatorormaybenot.png","metadata":{"files":{"readme":"README.md","changelog":null,"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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"creativecreatorormaybenot"}},"created_at":"2021-10-17T17:28:28.000Z","updated_at":"2025-01-24T04:06:53.000Z","dependencies_parsed_at":"2024-11-19T05:54:44.049Z","dependency_job_id":"15e5c40a-664e-46b5-ad81-eceab5271484","html_url":"https://github.com/creativecreatorormaybenot/performance","commit_stats":{"total_commits":22,"total_committers":3,"mean_commits":7.333333333333333,"dds":"0.18181818181818177","last_synced_commit":"f25bd3fa2a5ab255a51b9ec391cfda58f2023aaf"},"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creativecreatorormaybenot%2Fperformance","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creativecreatorormaybenot%2Fperformance/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creativecreatorormaybenot%2Fperformance/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/creativecreatorormaybenot%2Fperformance/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/creativecreatorormaybenot","download_url":"https://codeload.github.com/creativecreatorormaybenot/performance/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244102712,"owners_count":20398386,"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":["dart","flutter","flutter-package","flutter-web"],"created_at":"2024-10-11T04:06:15.368Z","updated_at":"2025-03-21T01:32:40.150Z","avatar_url":"https://github.com/creativecreatorormaybenot.png","language":"Dart","funding_links":["https://github.com/sponsors/creativecreatorormaybenot"],"categories":[],"sub_categories":[],"readme":"# performance [![Pub version][pub shield]][pub] [![demo badge]][demo] [![Twitter Follow][twitter badge]][twitter]\n\nPerformance overlay for Flutter apps that works on web.\n\n![sample]\n\n## Reading the charts\n\nYou can read the charts in the performance overlay like this:\n\n* Every bar represents a single frame.\n* The height of each bar represents the total time it took to render the frame.\n* The line indicates the target frame time (e.g. 16ms for 60 FPS) and frames\n  that cross that line turn red.\n* The overlay is divided into three charts.\n  - UI: the time it takes the UI to build.\n  - Raster: the time it takes to rasterize the frame.\n  - High latency: the total time between vsync start and raster finish, i.e. the\n    time it takes from an input to seeing the next frame.\n* The \"max\" value shows how long the worst sample in the displayed range took.\n* The \"avg\" value represents the average of all samples in the displayed range.\n* The displayed FPS value indicates the *best logically possible* number of\n  frames that could have been rendered per second. This might not be the actual\n  value, but the actual value is definitely not greater than this. This is\n  computed based on the average.\n\n## Limitations\n\nThe package is based on the [`FrameTiming` API][frame timing api]. Everything\ndocumented there applies. This should correspond one to one with the values you\nsee in the framework performance overlay on mobile and on native desktop. So if\nyou like how this looks better, you can also use this package on mobile and\nnative desktop :)\n\nOn web, however, it shows somewhat limited data. This is because performance\ndata from the GPU on web is not available in the `FrameTiming` instances (which\nwould be part of the raster duration on native). What is included in the raster\nduration on web are only parts of what is done on the GPU thread on native (due\nto limitations on the web which require running the computations on the UI\nthread).\nIf you want to access the GPU performance data, you can use Chrome DevTools or\n`chrome://tracing` for example.\n\n### Repo structure\n\nThis repo currently contains the following packages:\n\n| Package                      | Contents                                                                                                                                                                                         |\n| :--------------------------- | :----------------------------------------------------------------------------------------------- |\n| [`performance`][performance] | The actual `performance` Flutter package for the performance overlay that is also hosted on Pub. |\n\n[sample]: https://user-images.githubusercontent.com/19204050/139553925-73c30ef5-8756-4032-a6fb-55866a8979b6.png\n[twitter]: https://twitter.com/creativemaybeno\n[twitter badge]: https://img.shields.io/twitter/follow/creativemaybeno?label=Follow\u0026style=social\n[demo]: https://performance.creativemaybeno.dev\n[demo badge]: https://img.shields.io/badge/web-demo-yellow\n[performance]: https://github.com/creativecreatorormaybenot/performance/tree/main/performance\n[pub]: https://pub.dev/packages/performance\n[pub shield]: https://img.shields.io/pub/v/performance.svg\n[frame timing api]: https://api.flutter.dev/flutter/dart-ui/FrameTiming-class.html\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcreativecreatorormaybenot%2Fperformance","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcreativecreatorormaybenot%2Fperformance","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcreativecreatorormaybenot%2Fperformance/lists"}