Files
Itsycal/CONTRIBUTING.md
Sanjay 0a93ba5b15 Keep code signing settings out of pull requests
Move DEVELOPMENT_TEAM and provisioning settings out of project.pbxproj
into a gitignored Local.xcconfig, so contributor signing configs are
never accidentally committed. Add Local.xcconfig.example as a template,
CONTRIBUTING.md with setup instructions, and a GitHub Actions workflow
that fails any PR modifying signing settings in project.pbxproj.
2026-03-12 16:57:26 -07:00

1.1 KiB

Contributing to Itsycal

Thank you for your interest in contributing!

Setting Up Code Signing

Itsycal uses a local xcconfig file to manage code signing so that your personal signing settings are never committed to the repository.

Before opening Itsycal.xcodeproj, copy the example config:

cp Local.xcconfig.example Local.xcconfig

Local.xcconfig is gitignored and should never be committed.

Option 1 — No Apple Developer account

Leave the defaults as-is. Xcode will sign the app for local use only.

Option 2 — Your own Apple Developer account

Edit Local.xcconfig and set your 10-character team ID (found under Membership at developer.apple.com):

DEVELOPMENT_TEAM = XXXXXXXXXX
CODE_SIGN_STYLE = Manual

Submitting a Pull Request

Make sure your PR does not include changes to DEVELOPMENT_TEAM, DevelopmentTeam, or ProvisioningStyle in Itsycal.xcodeproj/project.pbxproj. If you see those in your diff, revert them — they are the result of Xcode writing your local signing settings into the project file. Setting up Local.xcconfig as described above will prevent this from happening.