Module Dependencies & API Surface

Executive summary

iOS architecture is hybrid: CocoaPods workspace at Costco/Costco.xcworkspace + 29 SPM packages under Costco-Digital/. The Features cluster has 21 packages; Core layer has 8 packages. SPM dependency graph is clean — Features depend on Core abstractions, not CoreImplementation.

SPM packages — complete list

Core layer (8 packages)

• Core — protocols, models, base utilities. Deps: swift-algorithms.
• CoreImplementation — concrete classes (CostcoNetworkClient, ServerTrustManager, Analytics). Depends on Core.
• Storage — persistence abstraction (Keychain, UserDefaults, CoreData).
• Translation — localization service.
• CostcoDesignSystem — Pallet tokens (UIKit + SwiftUI), shared components.
• CostcoHeader — header/navigation component.
• CostcoContentstack — Contentstack 1.5+ + Adobe Target/Optimize.
• ClientTool — internal tooling.

Features layer (21 packages)

• Home, Shop, Cart, MyAccount, Inbox, Search, DMC, PDP, List, Saving, GRS, Warehouse, Geofence, AppTutorial, AppRating, Accounts, Authentication, OnBoarding, PasskeyManagerKit, ThreatMetrixKit, CostcoCommon

Internal tooling / sample (3 packages)

• Mockey — internal mocking framework
• SampleCoreApp — development sample app
• SampleCostcoDesignSystem — design system playground

CocoaPods (Podfile)

Findings