{"id":27939562,"url":"https://github.com/macosui/macosui_starter","last_synced_at":"2025-05-07T09:55:02.899Z","repository":{"id":54249983,"uuid":"495565642","full_name":"macosui/macosui_starter","owner":"macosui","description":"A starter Flutter application for macOS that uses macos_ui","archived":false,"fork":false,"pushed_at":"2023-07-27T01:18:34.000Z","size":274,"stargazers_count":13,"open_issues_count":1,"forks_count":1,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-05-01T14:48:49.620Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/macosui.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2022-05-23T20:36:53.000Z","updated_at":"2023-12-14T21:40:28.000Z","dependencies_parsed_at":"2023-01-18T23:00:16.539Z","dependency_job_id":null,"html_url":"https://github.com/macosui/macosui_starter","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macosui%2Fmacosui_starter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macosui%2Fmacosui_starter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macosui%2Fmacosui_starter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/macosui%2Fmacosui_starter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/macosui","download_url":"https://codeload.github.com/macosui/macosui_starter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252856425,"owners_count":21814853,"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":"2025-05-07T09:55:01.997Z","updated_at":"2025-05-07T09:55:02.891Z","avatar_url":"https://github.com/macosui.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# macosui_starter\n\n![Powered by Mason](https://img.shields.io/endpoint?url=https%3A%2F%2Ftinyurl.com%2Fmason-badge)\n\nA starter Flutter application for macOS that uses [`macos_ui`](https://pub.dev/packages/macos_ui).\n\n\u003cimg src='https://imgur.com/O6XsnEB.png' /\u003e\n\n## 🚧 Prerequisites\n* Your Flutter version should be at least 3.0\n* You should have `mason_cli` installed\n\n## Usage 🚀\n```sh\nmason make macosui_starter\n```\n\nYou'll be prompted for the following information:\n* The name of your app\n* Your app's description\n* The name of your organization\n* Whether to show the debug label by default\n* Whether to add a basic custom system menu bar\n* Whether to initialize a git repository\n* Whether to add basic multi-window support **_(temporarily disabled)_**\n\n## Variables ✨\n\n| Variable                 | Description                                   | Default                                                 | Type      |\n|--------------------------|-----------------------------------------------|---------------------------------------------------------|-----------|\n| `app_name`               | The name of your app                          | `macosui_starter`                                       | `string`  |\n| `app_description`        | The description of your application           | `A starter Flutter application for macOS with macos_ui` | `string`  |\n| `org_name`               | The name of your organization                 | `com.example`                                           | `string`  |\n| `debug_label_on`         | Whether to show the debug label by default    | `false`                                                 | `boolean` |\n| `custom_system_menu_bar` | Whether to add a basic custom system menu bar | `false`                                                 | `boolean` |\n| `initialize_git_repo`    | Whether to initialize a git repository        | `false`                                                 | `boolean` |\n| `add_multi_window`       | Whether to add basic multi-window support     | `false`                                                 | `boolean` |\n\nSetting `custom_system_menu_bar` to `true` will add a basic custom system menu bar to your application, which looks \nlike this:\n\n\u003cimg src='https://imgur.com/yV7RR2E.png' /\u003e\n\n### 🚨 A Note About multi-window Support\nThe `add_multi_window` option worked by using a third-party plugin called `desktop_multi_window`, which creates new \nwindows by creating a new instance of the Flutter engine for each window. Unfortunately, this approach means that any \nplugins used by the primary instance are not passed to the new instances. There are workarounds for multiwindow \napplications using plugins that would require data passed between them; As of version 2.0, `macos_ui` uses the \n`macos_window_utils` plugin under the hood, the nature of which won't work with the workarounds.   \n\nTherefore, `add_multi_window` is disabled until multi-window is officially released in the Flutter framework itself. \n\n## Output 📦\n\nA Flutter application that:\n* Targets macOS (support for other platforms can be added manually)\n* Has `macos_ui` pre-installed\n* Builds basic UI based on the latest version of `macos_ui` ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmacosui%2Fmacosui_starter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmacosui%2Fmacosui_starter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmacosui%2Fmacosui_starter/lists"}