Canon · The books

Developer.

The doctrine that governs how code is shaped, shipped, and kept honest across Apple-platform Swift work, from the line in a file to the release in App Store Connect.

source: canon/developer/ · 10 documents

app-store-connect.md

App Store Connect

Routes every App Store Connect task (listings, sales, reviews, TestFlight, metadata, in-app purchases) through the appstore-connect MCP server as the only sanctioned path.

code-shape.md

Code shape

Governs how a single file and its functions look: Model-View with @Observable, no ViewModels, and where logic is allowed to live.

deep-linking.md

Deep linking

Defines how deep-link routes are registered, routed, and kept documented, treating each route as a public URL contract updated in the same PR that changes it.

github-workflow.md

GitHub workflow

Covers working with GitHub issues, PRs, and ProjectV2 boards via gh and GraphQL — the lifecycle footguns actually tripped on, plus the canonical label taxonomy every repo carries as minimum state.

localization.md

Localization

Sets the rule that all user-facing strings are localizable with an explicit bundle, using the natural string as the key, plus the .xcstrings workflow.

module-shape.md

Module shape

Decides when an app target should split into per-feature SPM packages and the shape that split takes, driven by empirical signals like strings-file size and compile times.

shared-code.md

Shared code

Sets stability-and-honesty policy for any module's public surface, scaling SemVer discipline by blast radius across three package tiers.

swiftlint.md

SwiftLint

Covers the discipline of running SwiftLint: per-session reconnaissance of version and config, and zero violations before any code is considered complete.

swiftui.md

SwiftUI

Covers SwiftUI runtime patterns and Apple-platform footguns, anchored by single-owner state rules for iOS and macOS.

xcode-build.md

Xcode build

Sets command-line build and test preferences: xcodebuild for apps, swift build/test for packages, with named triggers to fall back and the MCP server reserved for explicit requests.