{"id":14985585,"url":"https://github.com/yonaskolb/xcodegen","last_synced_at":"2025-05-13T15:07:04.886Z","repository":{"id":37285467,"uuid":"97716052","full_name":"yonaskolb/XcodeGen","owner":"yonaskolb","description":"A Swift command line tool for generating your Xcode project","archived":false,"fork":false,"pushed_at":"2025-04-15T12:56:04.000Z","size":12245,"stargazers_count":7300,"open_issues_count":361,"forks_count":825,"subscribers_count":92,"default_branch":"master","last_synced_at":"2025-04-15T13:46:14.883Z","etag":null,"topics":["ci","cli","generator","specification","swift","xcode","xcodeproj","xcodeproject","yaml"],"latest_commit_sha":null,"homepage":"","language":"Swift","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/yonaskolb.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","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":"2017-07-19T12:56:04.000Z","updated_at":"2025-04-15T12:50:24.000Z","dependencies_parsed_at":"2023-10-02T07:03:54.295Z","dependency_job_id":"899e6264-de59-4a99-92ef-a4cce3794214","html_url":"https://github.com/yonaskolb/XcodeGen","commit_stats":{"total_commits":1824,"total_committers":230,"mean_commits":7.930434782608696,"dds":0.5526315789473684,"last_synced_commit":"2cf88e8088b6c1531080b10d2bfb169e2dc22379"},"previous_names":[],"tags_count":79,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yonaskolb%2FXcodeGen","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yonaskolb%2FXcodeGen/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yonaskolb%2FXcodeGen/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yonaskolb%2FXcodeGen/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yonaskolb","download_url":"https://codeload.github.com/yonaskolb/XcodeGen/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250230136,"owners_count":21396241,"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":["ci","cli","generator","specification","swift","xcode","xcodeproj","xcodeproject","yaml"],"created_at":"2024-09-24T14:11:15.472Z","updated_at":"2025-04-22T11:25:33.428Z","avatar_url":"https://github.com/yonaskolb.png","language":"Swift","readme":"\u003cp align=\"center\"\u003e\n\u003ca href=\"https://github.com/yonaskolb/XcodeGen\"\u003e\n\u003cimg src=\"Assets/Logo_animated.gif\" alt=\"XcodeGen\" /\u003e\n\u003c/a\u003e\n\u003c/p\u003e\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/yonaskolb/XcodeGen/releases\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/release/yonaskolb/xcodegen.svg\"/\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://swiftpackageindex.com/yonaskolb/XcodeGen\"\u003e\n    \u003cimg src=\"https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fyonaskolb%2FXcodeGen%2Fbadge%3Ftype%3Dplatforms\" alt=\"Swift Package Manager Platforms\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://swiftpackageindex.com/yonaskolb/XcodeGen\"\u003e\n    \u003cimg src=\"https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fyonaskolb%2FXcodeGen%2Fbadge%3Ftype%3Dswift-versions\" alt=\"Swift Versions\" /\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/yonaskolb/XcodeGen/blob/master/LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/license/yonaskolb/XcodeGen.svg\"/\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n# XcodeGen\n\nXcodeGen is a command line tool written in Swift that generates your Xcode project using your folder structure and a project spec.\n\nThe project spec is a YAML or JSON file that defines your targets, configurations, schemes, custom build settings and many other options. All your source directories are automatically parsed and referenced appropriately while preserving your folder structure. Sensible defaults are used in many places, so you only need to customize what is needed. Very complex projects can also be defined using more advanced features.\n\n- ✅ Generate projects on demand and remove your `.xcodeproj` from git, which means **no more merge conflicts**!\n- ✅ Groups and files in Xcode are always **synced** to your directories on disk\n- ✅ Easy **configuration** of projects which is human readable and git friendly\n- ✅ Easily copy and paste **files and directories** without having to edit anything in Xcode\n- ✅ Share build settings across multiple targets with **build setting groups**\n- ✅ Automatically generate Schemes for **different environments** like test and production\n- ✅ Easily **create new projects** with complicated setups on demand without messing around with Xcode\n- ✅ Generate from anywhere including on **CI**\n- ✅ Distribute your spec amongst multiple files for easy **sharing** and overriding\n- ✅ Easily create **multi-platform** frameworks\n- ✅ Integrate **Carthage** frameworks without any work\n\nGiven an example project spec:\n\n```yaml\nname: MyProject\ninclude:\n  - base_spec.yml\noptions:\n  bundleIdPrefix: com.myapp\npackages:\n  Yams:\n    url: https://github.com/jpsim/Yams\n    from: 2.0.0\ntargets:\n  MyApp:\n    type: application\n    platform: iOS\n    deploymentTarget: \"10.0\"\n    sources: [MyApp]\n    settings:\n      configs:\n        debug:\n          CUSTOM_BUILD_SETTING: my_debug_value\n        release:\n          CUSTOM_BUILD_SETTING: my_release_value\n    dependencies:\n      - target: MyFramework\n      - carthage: Alamofire\n      - framework: Vendor/MyFramework.framework\n      - sdk: Contacts.framework\n      - sdk: libc++.tbd\n      - package: Yams\n  MyFramework:\n    type: framework\n    platform: iOS\n    sources: [MyFramework]\n```\nA project would be created with 2 connected targets, with all the required configurations and build settings. See the [Project Spec](Docs/ProjectSpec.md) documentation for all the options you can specify, and [Usage](Docs/Usage.md) for more general documentation.\n\n## Installing\n\nMake sure the latest stable (non-beta) version of Xcode is installed first.\n\n### [Mint](https://github.com/yonaskolb/mint)\n```sh\nmint install yonaskolb/xcodegen\n```\n\n### Make\n\n```shell\ngit clone https://github.com/yonaskolb/XcodeGen.git\ncd XcodeGen\nmake install\n```\n\n### Homebrew\n\n```shell\nbrew install xcodegen\n```\n\n### Swift Package Manager\n\n**Use as CLI**\n\n```shell\ngit clone https://github.com/yonaskolb/XcodeGen.git\ncd XcodeGen\nswift run xcodegen\n```\n\n**Use as dependency**\n\nAdd the following to your Package.swift file's dependencies:\n\n```swift\n.package(url: \"https://github.com/yonaskolb/XcodeGen.git\", from: \"2.43.0\"),\n```\n\nAnd then import wherever needed: `import XcodeGenKit`\n\n## Usage\n\nSimply run:\n\n```shell\nxcodegen generate\n```\n\nThis will look for a project spec in the current directory called `project.yml` and generate an Xcode project with the name defined in the spec.\n\nOptions:\n\n- **--spec**: An optional path to a `.yml` or `.json` project spec. Defaults to `project.yml`. (It is also possible to link to multiple spec files by comma separating them. Note that all other flags will be the same.)\n- **--project**: An optional path to a directory where the project will be generated. By default this is the directory the spec lives in.\n- **--quiet**: Suppress informational and success messages.\n- **--use-cache**: Used to prevent unnecessarily generating the project. If this is set, then a cache file will be written to when a project is generated. If `xcodegen` is later run but the spec and all the files it contains are the same, the project won't be generated.\n- **--cache-path**: A custom path to use for your cache file. This defaults to `~/.xcodegen/cache/{PROJECT_SPEC_PATH_HASH}`\n\nThere are other commands as well such as `xcodegen dump` which lets one output the resolved spec in many different formats, or write it to a file. Use `xcodegen help` to see more detailed usage information.\n\n## Editing\n```shell\ngit clone https://github.com/yonaskolb/XcodeGen.git\ncd XcodeGen\nswift package generate-xcodeproj\n```\nThis uses Swift Package Manager to create an `xcodeproj` file that you can open, edit and run in Xcode, which makes editing any code easier.\n\nIf you want to pass any required arguments when running in Xcode, you can edit the scheme to include launch arguments.\n\n## Documentation\n- See [Project Spec](Docs/ProjectSpec.md) documentation for all the various properties and options that can be set\n- See [Usage](Docs/Usage.md) for more specific usage and use case documentation\n- See [FAQ](Docs/FAQ.md) for a list of some frequently asked questions\n- See [Examples](Docs/Examples.md) for some real world XcodeGen project specs out in the wild\n\n## Alternatives\nIf XcodeGen doesn't meet your needs try these great alternatives:\n- [Tuist](https://github.com/tuist/tuist)\n- [Xcake](https://github.com/igor-makarov/xcake)\n- [struct](https://github.com/workshop/struct)\n\n## Attributions\nThis tool is powered by:\n\n- [XcodeProj](https://github.com/tuist/XcodeProj)\n- [JSONUtilities](https://github.com/yonaskolb/JSONUtilities)\n- [Spectre](https://github.com/kylef/Spectre)\n- [PathKit](https://github.com/kylef/PathKit)\n- [Yams](https://github.com/jpsim/Yams)\n- [SwiftCLI](https://github.com/jakeheis/SwiftCLI)\n\nInspiration for this tool came from:\n\n- [struct](https://github.com/workshop/struct)\n- [Xcake](https://github.com/igor-makarov/xcake)\n- [CocoaPods Xcodeproj](https://github.com/CocoaPods/Xcodeproj)\n\n## Contributions\nPull requests and issues are always welcome. Please open any issues and PRs for bugs, features, or documentation.\n\n[![](https://sourcerer.io/fame/yonaskolb/yonaskolb/XcodeGen/images/0)](https://sourcerer.io/fame/yonaskolb/yonaskolb/XcodeGen/links/0)[![](https://sourcerer.io/fame/yonaskolb/yonaskolb/XcodeGen/images/1)](https://sourcerer.io/fame/yonaskolb/yonaskolb/XcodeGen/links/1)[![](https://sourcerer.io/fame/yonaskolb/yonaskolb/XcodeGen/images/2)](https://sourcerer.io/fame/yonaskolb/yonaskolb/XcodeGen/links/2)[![](https://sourcerer.io/fame/yonaskolb/yonaskolb/XcodeGen/images/3)](https://sourcerer.io/fame/yonaskolb/yonaskolb/XcodeGen/links/3)[![](https://sourcerer.io/fame/yonaskolb/yonaskolb/XcodeGen/images/4)](https://sourcerer.io/fame/yonaskolb/yonaskolb/XcodeGen/links/4)[![](https://sourcerer.io/fame/yonaskolb/yonaskolb/XcodeGen/images/5)](https://sourcerer.io/fame/yonaskolb/yonaskolb/XcodeGen/links/5)[![](https://sourcerer.io/fame/yonaskolb/yonaskolb/XcodeGen/images/6)](https://sourcerer.io/fame/yonaskolb/yonaskolb/XcodeGen/links/6)[![](https://sourcerer.io/fame/yonaskolb/yonaskolb/XcodeGen/images/7)](https://sourcerer.io/fame/yonaskolb/yonaskolb/XcodeGen/links/7)\n\n## License\n\nXcodeGen is licensed under the MIT license. See [LICENSE](LICENSE) for more info.\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyonaskolb%2Fxcodegen","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyonaskolb%2Fxcodegen","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyonaskolb%2Fxcodegen/lists"}