{"id":13751292,"url":"https://github.com/globulus/swiftui-recipes-companion","last_synced_at":"2026-02-18T10:00:30.268Z","repository":{"id":90392581,"uuid":"390315405","full_name":"globulus/swiftui-recipes-companion","owner":"globulus","description":"Companion app and XCode extension for adding SwiftUI recipes to your code.","archived":false,"fork":false,"pushed_at":"2024-03-19T05:54:12.000Z","size":3570,"stargazers_count":31,"open_issues_count":0,"forks_count":4,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-05-09T18:32:11.521Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"HTML","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/globulus.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-07-28T10:47:42.000Z","updated_at":"2025-03-28T09:14:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"3b9964d8-3979-41f2-a1bd-a2b6d1b584ac","html_url":"https://github.com/globulus/swiftui-recipes-companion","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/globulus/swiftui-recipes-companion","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/globulus%2Fswiftui-recipes-companion","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/globulus%2Fswiftui-recipes-companion/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/globulus%2Fswiftui-recipes-companion/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/globulus%2Fswiftui-recipes-companion/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/globulus","download_url":"https://codeload.github.com/globulus/swiftui-recipes-companion/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/globulus%2Fswiftui-recipes-companion/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29575343,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-18T08:38:15.585Z","status":"ssl_error","status_checked_at":"2026-02-18T08:38:14.917Z","response_time":162,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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-03T09:00:41.505Z","updated_at":"2026-02-18T10:00:30.259Z","avatar_url":"https://github.com/globulus.png","language":"HTML","funding_links":[],"categories":["🌎 by the community"],"sub_categories":[],"readme":"# SwiftUI Recipes Companion\n\nFree Companion app and XCode extension for adding SwiftUI recipes to your code.\n\nChoose from a rich selection of SwiftUI recipes, that range from simple tasks to entire custom components:\n\n![Companion App](https://github.com/globulus/swiftui-recipes-companion/blob/main/Images/companionApp.png?raw=true)\n\nThen, simply insert their code straight into yours via the **Editor** menu:\n\n![Companion App](https://github.com/globulus/swiftui-recipes-companion/blob/main/Images/editorExtension.png?raw=true)\n\n**Be sure to check out the [online version](https://swiftuirecipes.com/companion) as well!**\n\n## Installation\n\n* [Download and install the app from the App Store](https://apps.apple.com/us/app/swiftui-recipes/id1579235956). \n* Run the **companion app first** (search **Applications -\u003e SwiftUI Recipes**). It'll fetch the list of recipes from Github and allow you to preview their content/code and exclude those you don't want in your Editor menu. After you're done, be sure to press the **Save** button.\n* Go to **System Preferences -\u003e Extensions -\u003e Xcode Source Editor -\u003e Check `Helper` (with SwiftUI Recipes app icon)**.\n* Run Xcode (or restart if it was open) and go to **Editor -\u003e Recipes -\u003e ...**. Pressing any recipe command will insert its code at your cursor. There's also the special **Run Companion** command that will start the companion app again.\n\n## Usage\n\n**Companion App**:\n \n * The list of recipes will be fetched automatically, but you can pull it again with **Refresh**.\n * Click the recipe to see its details, image and code.\n * Checkmark on left-hand side means that the recipe will show up in your XCode Extension. If you click it, it turns into a red X and then the recipe is excluded.\n * Click **Save** to store the recipes locally to that the XCode extension can use them.\n * Regularly check for new recipes, as new ones are added on a daily basis.\n\n**Source Editor Extension**:\n\n * Open a project and one of its source files.\n * Go to the menu, **Editor -\u003e Recipes -\u003e ..** and select a recipe to insert its code at your cursor.\n * Click **Editor -\u003e Recipes -\u003e Run Companion** to open the companion app again. If you make any changes in the companion app, you'll have to restart XCode for the changes to take effect.\n\n## Contributing Recipes\n\nAll the recipes are open source and live in the [Recipes folder in the Git](https://github.com/globulus/swiftui-recipes-companion/tree/main/Recipes).\n\n**Any contributions are more than welcome! Let's grow the cookbook together!**\n\nTo contribute a recipe, simply **create a PR with a new recipe file**. A recipe file is a *yml* with the following structure:\n\n```yaml\n---\ntitle: \"Title of the recipe, as it'll appear in the App/Extension. Can only contain slash / and parentheses () as special characters.\"\ndescription: \"Give a short description of the recipe here.\"\nauthor: \"Your name or email address.\"\nurl: \"Optional, URL to more details on the subject.\"\nimage: \"Optional, URL to the image accompanying the recipe. Feel free to include the image in the PR.\"\nupdatedAt: \"ISO-formatted timestamp of the latest recipe update.\"\nminSwiftUIVersion: Minimum SwiftUI version that supports the recipe, e.g 1, 2, 3\nmaxSwiftUIVersion: Optional, if the recipe got deprecated in a newer SwiftUI version.\n---\nRECIPE CODE GOES HERE\n```\n\n## Blog\n\nCheck out [SwiftUIRecipes.com](https://swiftuirecipes.com) for in-depth explanations of common, yet puzzling SwiftUI tasks.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fglobulus%2Fswiftui-recipes-companion","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fglobulus%2Fswiftui-recipes-companion","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fglobulus%2Fswiftui-recipes-companion/lists"}