{"id":24714442,"url":"https://github.com/ml-opensource/swiftui-template-tca","last_synced_at":"2025-10-09T12:31:40.249Z","repository":{"id":106622755,"uuid":"596935195","full_name":"ml-opensource/swiftui-template-tca","owner":"ml-opensource","description":null,"archived":false,"fork":false,"pushed_at":"2024-06-26T09:02:52.000Z","size":1292,"stargazers_count":12,"open_issues_count":0,"forks_count":7,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-06-26T10:31:48.417Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Swift","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ml-opensource.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":null,"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":"2023-02-03T08:55:37.000Z","updated_at":"2024-06-26T10:31:52.147Z","dependencies_parsed_at":"2024-06-26T10:41:52.958Z","dependency_job_id":null,"html_url":"https://github.com/ml-opensource/swiftui-template-tca","commit_stats":null,"previous_names":["ml-opensource/swiftui-template-tca"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ml-opensource%2Fswiftui-template-tca","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ml-opensource%2Fswiftui-template-tca/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ml-opensource%2Fswiftui-template-tca/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ml-opensource%2Fswiftui-template-tca/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ml-opensource","download_url":"https://codeload.github.com/ml-opensource/swiftui-template-tca/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":235820061,"owners_count":19050101,"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-01-27T08:16:36.885Z","updated_at":"2025-10-09T12:31:34.688Z","avatar_url":"https://github.com/ml-opensource.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"## iOS Project Template for SwiftUI\n[![IDE](https://img.shields.io/badge/Xcode-15-blue.svg)](https://developer.apple.com/xcode/)\n[![Language](https://img.shields.io/badge/swift-5.9-orange.svg)](https://swift.org)\n[![Platform](https://img.shields.io/badge/iOS-16-green.svg)](https://developer.apple.com/ios/)\n[![Build Status](https://github.com/monstar-lab-oss/swiftui-template-tca/actions/workflows/build.yml/badge.svg)](https://github.com/monstar-lab-oss/swiftui-template-tca/actions/workflows/build.yml)\n\n\nProject template to jumpstart your next iOS project with integrating best practices and tools.\n\n## Motivation\n\nEverytime we create a new project, we do lots of repeated tasks that kills our effective hours. \nThis template will save those hours and help to follow standard project architecture.\n\n\n## Best Practices\n* [Composable Architecture](https://github.com/pointfreeco/swift-composable-architecture) TCA/Composable Architecture of iOS app using Combine and SwiftUI\n* [R.swift](https://github.com/mac-cain13/R.swift) Get strong typed, autocompleted resources like images, fonts and segues in Swift projects\n* [Standard gitignore](https://github.com/github/gitignore/blob/master/Swift.gitignore)\n* [Moya](https://github.com/Moya/Moya) for netwoking layer\n* [Swift-Format](https://github.com/apple/swift-format) [For doing code formatting transformations]\n* Development, Staging and Production app flavours\n* Separate build configuration for each flavour\n\n### Todo\n* Base classes for handling deeplink, notifications and multiple scheme\n\n### Supporting Tools\nXcode 14.0 or later and Swift 5.5 or later.\n\n### Prerequisites:\n* [Cookiecutter](https://cookiecutter.readthedocs.io/en/latest/installation.html)\n\nInstall cookiecutter by runing below terminal command.\n\n```\nbrew install cookiecutter\n```\n\n## Usage\n\nThe project template uses Cookiecutter to create your project from it. Run the below command to create your project:\n\n```\ncookiecutter git@github.com:monstar-lab-oss/swiftui-template-tca.git\n```\nEnter your desire app name followed by company name. Thats it, you should be able to see your app directory created based on the template.\n\n## Build Configurations\nThe templete used `.xcconfig` and `BuildConfiguration.plist` files to maintain different environments(Development/Staging/Production). To know how it is done please follow the [link](https://medium.com/better-programming/how-to-create-development-staging-and-production-configs-in-xcode-ec58b2cc1df4).\n## Additional configuration\n\nYou will have to manually configure the bundle id of the main target and test target.\n\n## TCA Template Installation\nAll the Xcode custom template files are located in ~/Library/Developer/Xcode/Templates/ and grouped into sections by folder name. Create a folder with name `Custom Templates` manually or by running the following command from the terminal:\n\n```\nmkdir ~/Library/Developer/Xcode/Templates/Custom Templates\n```\n\nNow drag and drop the `TCA.xctemplate` that included with the repo to the `Custom Templates` directory. Now the TCA template can be selected from File Templates\n\n![](assets/tca_template.gif)\n\n## Contributing Code\nPlease refer to [Contributing Guidelines](https://github.com/monstar-lab-oss/swiftui-template-tca/blob/main/CONTRIBUTING.md) before participating.\n\n\n## Acknowledgments\n\n* [iOS Project Best Practices and Tools](https://medium.com/@piotr.gorzelany/ios-project-best-practices-and-tools-c46135b8116d)\n* [Development, Staging and Production Configs in Xcode](https://medium.com/better-programming/how-to-create-development-staging-and-production-configs-in-xcode-ec58b2cc1df4)\n* [iOS Build Management using Custom Build Scheme](https://www.talentica.com/blogs/ios-build-management-using-custom-build-scheme/)\n\n## 👥 Credits\nMade with ❤️ at Monstarlab\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fml-opensource%2Fswiftui-template-tca","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fml-opensource%2Fswiftui-template-tca","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fml-opensource%2Fswiftui-template-tca/lists"}