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, the infra-seam dependency-injection idiom, and where logic is allowed to live; fixes the in-repo design-system token files as the single source of truth that a web design sandbox exports into, never the reverse.

deep-linking.md

Deep linking

Requires URL-driven navigation on iOS and macOS app targets to run through the Iris router (a parsing codec, a navigation flow, a plumbed coordinator) rather than bespoke URL handling, with the happy-path wiring as the bar; deep-link routes stay documented public URL contracts updated in the same PR that changes them.

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; carves out the one exception, an AppIntents LocalizedStringResource, which must resolve against the main bundle (an explicit bundle halts metadata export).

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, fixes the repository layout that houses the result, and carves out the packaged styling module.

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 for iOS and macOS, anchored by single-owner state rules and the colour design-system expectation.

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.