{"id":15153460,"url":"https://github.com/flutter/cocoon","last_synced_at":"2025-05-16T04:04:25.940Z","repository":{"id":37587775,"uuid":"63260554","full_name":"flutter/cocoon","owner":"flutter","description":"Flutter's build coordinator and aggregator","archived":false,"fork":false,"pushed_at":"2025-05-13T23:25:08.000Z","size":22872,"stargazers_count":215,"open_issues_count":8,"forks_count":102,"subscribers_count":80,"default_branch":"main","last_synced_at":"2025-05-14T00:07:05.426Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Dart","has_issues":false,"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/flutter.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2016-07-13T16:04:04.000Z","updated_at":"2025-05-13T23:25:12.000Z","dependencies_parsed_at":"2023-10-17T02:03:28.771Z","dependency_job_id":"6101ddd7-3b3d-4b78-a066-66d992860859","html_url":"https://github.com/flutter/cocoon","commit_stats":{"total_commits":3514,"total_committers":89,"mean_commits":39.48314606741573,"dds":0.6696072851451338,"last_synced_commit":"9ce7413cbef766dce26482b5d97ac4bb2f51cee9"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flutter%2Fcocoon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flutter%2Fcocoon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flutter%2Fcocoon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flutter%2Fcocoon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/flutter","download_url":"https://codeload.github.com/flutter/cocoon/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254464891,"owners_count":22075570,"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-09-26T17:00:43.255Z","updated_at":"2025-05-16T04:04:25.921Z","avatar_url":"https://github.com/flutter.png","language":"Dart","readme":"\u003ca href=\"https://github.com/flutter/cocoon\"\u003e\n  \u003ch1 align=\"center\"\u003e\n    \u003cpicture\u003e\n      \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://storage.googleapis.com/cms-storage-bucket/6e19fee6b47b36ca613f.png\"\u003e\n      \u003cimg alt=\"Flutter\" src=\"https://storage.googleapis.com/cms-storage-bucket/c823e53b3a1a7b0d36a9.png\"\u003e\n    \u003c/picture\u003e\n  \u003c/h1\u003e\n\u003c/a\u003e\n\n\n[![Flutter CI Status](https://flutter-dashboard.appspot.com/api/public/build-status-badge?repo=cocooon)](https://flutter-dashboard.appspot.com/#/build?repo=cocoon\u0026branch=main)\n[![SLSA 3](https://slsa.dev/images/gh-badge-level3.svg)](https://slsa.dev)\n\n**Cocoon** is a Dart App Engine custom runtime (backend) with a frontend\nof Flutter apps (build and repository dashboard). Cocoon coordinates\nand aggregates the results of [flutter/flutter](https://github.com/flutter/flutter)\nbuilds.\n\nIt is not designed to help developers build Flutter apps.\n\nCocoon is not a Google product.\n\n\n# Using Cocoon\n\n## Forcing a refresh from GitHub\n\nThe server is driven by commits made to\nhttps://github.com/flutter/flutter repo. It periodically syncs new\ncommits. If you need to manually force a refresh, query\n`https://flutter-dashboard.appspot.com/api/refresh-github-commits`.\n\nYou will need to be authenticated with Cocoon to do this.\n\n\n# Developing Cocoon\n\nCocoon has several components:\n\n* A server, which coordinates everything. This is a Dart App Engine\n  application. If you have never used that before, you may want to\n  [peruse the samples for Dart App\n  Engine](https://github.com/dart-lang/appengine_samples). The server\n  is found in [app_dart](app_dart/).\n\n* A Flutter app (generally used as a Web app) for the build\n  dashboards. The dashboard is found in [dashboard](dashboard/).\n\nCocoon creates a _checklist_ for each Flutter commit. A checklist is\nmade of multiple _tasks_. Tasks are _performed_ by _LUCI bots_.\n\n\n## Getting started\n\nFirst, [set up a Flutter development\nenvironment](https://github.com/flutter/flutter/blob/master/CONTRIBUTING.md#developing-for-flutter).\nThis will, as a side-effect, provide you with a Dart SDK. Your life\nwill be easier if you add that (`.../flutter/bin/cache/dart-sdk/bin/`)\nto your path.\n\nTo update the production server, you will need the [Google Cloud\nSDK](https://cloud.google.com/sdk/docs/quickstarts). Since there is no\nDart SDK, we just use the command line tools.\n\n\n## Developing the server\n\nAll the commands in this section assume that you are in the\n`app_dart/` directory.\n\n### Running a local dev server\n\n```sh\ndart bin/local_server.dart\n```\n\nThis will output `Serving requests at 0.0.0.0:8080` indicating the server is working.\n\nNew requests will be logged to the console.\n\n### Deploying a test version on Google Cloud\n\nTo run live tests, build the app, and provide instructions for deploying to\nGoogle App Engine, run this command:\n\n```sh\ndart dev/deploy.dart --project {PROJECT} --version {VERSION}\n```\n\nYou can test the new version by accessing\n`{VERSION}-dot-flutter-dashboard.appspot.com` in your browser. If the\nresult is satisfactory, the new version can be activated by using the\nCloud Console UI:\n\u003chttps://console.cloud.google.com/appengine/versions?project=flutter-dashboard\u0026serviceId=default\u003e\n\n#### Optional flags\n\n`--profile`: Deploy a profile mode of `dashboard` application for debugging purposes.\n\n`--ignore-version-check`: Ignore the version of Flutter on path (expects to be relatively recent)\n\n\n## Developing the dashboard\n\nThe dashboard application will use dummy data when it is not connected\nto the server, so it can be developed locally without a dev server.\n\nTo run the dashboard locally, go into the `dashboard` directory and\nrun `flutter run -d chrome`. The dashboard will be served from localhost\n(the exact address will be given on the console); copy the URL into\nyour browser to view the application. (The dashboard should also be\nable to run on non-Web platforms, but since the Web is our main target\nthat is the one that should generally be used for development.)\n\nYou can run `flutter packages upgrade` to update the dependencies.\nThis may be necessary if you see a failure in the dependencies.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflutter%2Fcocoon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflutter%2Fcocoon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflutter%2Fcocoon/lists"}