Why ignore the DerivedData folder?

DerivedData holds Xcode build intermediates, indexes and module caches that are rebuilt from your source on every compile. It is large, machine-specific and should never be committed.

Should I commit the Pods/ folder?

It is a matter of team policy. Ignoring Pods/ keeps the repo small and forces a pod install, which some teams prefer; others commit it for reproducible builds without network access. The CocoaPods block ignores it by default.

Why ignore xcuserdata but keep the project file?

The xcuserdata directories store per-developer window layouts, breakpoints and scheme selections. Ignoring them avoids constant churn, while the shared .xcodeproj and .xcworkspace structure stays in version control.

What about Package.resolved for Swift Package Manager?

Apps usually commit Package.resolved to pin exact dependency versions, while libraries often ignore it. This builder includes it in the SPM block — remove that line if your project is a reusable package.

Is anything uploaded to a server?

No. The templates are built into the page and the file is assembled entirely in your browser, so nothing about your project is sent anywhere.

.gitignore Builder for iOS / Xcode

Email me this result

Get this tool's output sent to your inbox, plus one useful tool a week. No spam, unsubscribe any time.

A .gitignore builder for iOS and macOS projects developed in Xcode. Pick your dependency manager and tooling, and the tool assembles the right ignore patterns for build artifacts, per-developer settings and CI output into one labelled file.

How it works

Each toggle adds a curated block of patterns under a # Header comment. The Xcode block ignores the DerivedData/ build cache, user state files like *.xcuserstate, and packaged *.ipa and *.dSYM artifacts. The dependency blocks handle the three common managers: Pods/ for CocoaPods, Carthage/Build/ for Carthage, and .build/ plus .swiftpm/ for Swift Package Manager. Workspace and Fastlane blocks cover per-developer settings and CI report output.

What gets ignored

DerivedData/ and build/ hold compiled output and are always excluded. The workspace block ignores xcuserdata inside .xcworkspace and .xcodeproj, keeping only the shared project structure tracked. The Fastlane block ignores generated report.xml, Preview.html and screenshot output so automated runs do not pollute the repo.

Tips

Place the file at the root of your repository. Decide as a team whether to commit Pods/ — ignoring it keeps the repo lean but requires pod install after clone. For app targets, commit Package.resolved to pin SPM dependency versions; for reusable packages, ignore it. If a build file is already tracked, run git rm --cached <file> and commit so the ignore rule applies.