Skip to content

docs(packaging): document forking/renaming the bundle identifier - #341

Merged
dbgeek merged 1 commit into
mainfrom
docs/fork-bundle-id
Jul 30, 2026
Merged

docs(packaging): document forking/renaming the bundle identifier#341
dbgeek merged 1 commit into
mainfrom
docs/fork-bundle-id

Conversation

@dbgeek

@dbgeek dbgeek commented Jul 30, 2026

Copy link
Copy Markdown
Owner

What

Adds a "Forking / renaming the bundle identifier" section to docs/packaging.md, between "Why a stable signing identity" and the signing-identity setup.

Why

me.ba78.type-wave is the maintainer's domain-derived (ba78.meme.ba78) reverse-DNS bundle id, and the docs previously presented it as a fixed given — a cloner had no guidance on whether they need their own, or which files to touch. The section:

  • States that keeping it for a local build is harmless (internally-consistent string; each build is signed with the builder's own `type-wave dev` cert, so its Designated Requirement never collides with anyone else's install).
  • Lists every load-bearing site to change when forking to distribute:
    • `packaging/install.sh` — `BUNDLE_ID` + `LABEL`
    • `packaging/Info.plist` — `CFBundleIdentifier`
    • `packaging/me.ba78.type-wave.plist` — the `Label` value and the filename (`install.sh` renders `packaging/$LABEL.plist`)
    • `src/keychain.zig` — the `service` constant
  • Notes `src/info_plist.zig` is only a doc comment (real value embedded from `Info.plist`), so it's accuracy-only.

Doc-only change; no code or build touched.

🤖 Generated with Claude Code

Clarify that me.ba78.type-wave is the maintainer's domain-derived
bundle id: harmless to keep for a local build, but list every site to
change when forking to distribute (install.sh BUNDLE_ID/LABEL,
Info.plist CFBundleIdentifier, the plist Label + filename, and the
keychain service constant).
@dbgeek
dbgeek enabled auto-merge (squash) July 30, 2026 21:12
@dbgeek
dbgeek merged commit 2f0dd69 into main Jul 30, 2026
2 checks passed
@dbgeek
dbgeek deleted the docs/fork-bundle-id branch July 30, 2026 21:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant