Quick Stats
- Swift 6 + iOS 26 Liquid Glass: v2.2.0 builds under strict concurrency with the iOS 26 SDK (Xcode 26.2+)
- 276+ hours of development already done
- ~598 tests across 12 package test targets + the app test suites, run in one pass
- 11 Swift Packages cleanly separated for reuse in any iOS project
- AI-Assisted Development with Claude Code CLAUDE.md, Cursor AI rules, and Bolt AI chat modes
- Comprehensive docs with examples and LLM prompt packs
- 2 chat UIs (bubble and centered styles)
- Localization & Accessibility built-in for global, inclusive apps
New in v2.2
The v2.2.0 release is built around shipping a differentiated app from the template — getting past App Store Review Guideline 4.3(a) (“spam”/duplicate apps) and hardening the codebase for production.- ✅ App Store 4.3(a) playbook —
scripts/appstore-43-audit.shruns a Release-binarystringsaudit that fails the build while un-rebranded starter fingerprints (SwiftAI,Boilerplate, theSAIdesign-system prefix), the starterBrandConfig.appDisplayName, placeholder legal URLs, or the starter bundle ID remain. Paired withdocs/checklists/APP_STORE_4_3_HARDENING.mdand prompt packs indocs/prompts/AppStore4_3Hardening.prompts.md. - ✅
template.manifest.json(repo root) — machine-readable single source of truth for the identity surface, module graph (which packages are removable and their couplings), config schema, canonical fingerprint list, differentiation rules, and verification commands. Consumed by the audit script + CI; validated byscripts/validate-template-manifest.sh. - ✅ Hero archetype recipes —
docs/recipes/hero/ships DashboardGrid, FeedTimeline, MapCanvas, GuidedTaskFlow, and ConversationalHome, plus onboarding/paywall/feature recipes. 4.3 differentiation comes from mandatory archetype selection, not randomness. - ✅
TestSupportpackage + single workspace test plan — a test-only infrastructure package (URLProtocolStub) feedsBoilerplate.xctestplan, which runs ~598 tests across 12 package test targets + the app test suites in onexcodebuild test. - ✅ Localized error surface —
AppError.localizedUserMessage(English + Spanish) in Localization, now linked by the app target, FeatureSettings, and FeatureChat; every UI error call site migrated. - ✅ Single-source app identity — every target’s bundle ID and app-group entitlements derive from one
APP_BUNDLE_IDinConfig/App.xcconfig; stale upstream fingerprints purged. - ✅ Production hardening — DEBUG-only
MockAuthClient, configurable HTTPS legal URLs (no placeholder bodies in Release), an explicit unconfigured-backend failure path (nohttps://api.example.comfallback), and account deletion viaAccountDeletionClient+ asupabase/functions/delete-account/Edge Function template.
Still current from v2.0
- ✅ iOS 26 Liquid Glass via
SAIGlassprimitive, with automaticMaterialfallback on iOS 17–25 - ✅ Swift 6 strict concurrency across every package
- ✅
@MainActor-pinned storage repositories and@Observableview models throughout - ✅ ≤ 400-line file rule enforced across the codebase (extension-split siblings)
- ✅ Secrets pre-commit hook in
.githooks/ - ✅ Xcode 26.3 pin via
.xcode-version
The App Generator is a separate, standalone macOS product (coming soon) that drives your own coding-agent CLI to generate a differentiated, 4.3-safe app from this template — it is not bundled in the boilerplate. See the license & pricing reference for the full model.
Core Features
AI-Assisted Development
- ✅ Production-tested
CLAUDE.mdfor agentic development with Claude Code - ✅ 6 comprehensive Cursor AI
.mdcrule files - ✅ 12 specialized Bolt AI chat modes
- ✅ Per-module PROMPTS.md with ready-to-paste prompts
- ✅ DesignSystem usage enforced by AI
- ✅ Protocol-based dependencies automatically
- ✅ MVVM architecture patterns followed
- ✅ Swift best practices (async/await, @MainActor, Sendable)
- ✅ Zero setup for all three tools
Authentication
- ✅ Email/password via Supabase
- ✅ Sign in with Apple and/or Google, via Supabase
- ✅ Automatic token refresh
- ✅ Secure Keychain storage
- ✅ DEBUG-only
MockAuthClientfor development
AI Integration
- ✅ Streaming chat responses
- ✅ 500+ models via OpenRouter
- ✅ Secure Edge Function proxy (
ProxyLLMClient→supabase/functions/ai/; key stays server-side) - ✅ Cancellable requests
- ✅
EchoLLMClientdev fallback whenPROXY_BASE_URLis empty - ✅ Easily replaceable with your own APIs
Chat UI
- ✅ Dual UI styles (bubble + centered)
- ✅ Real-time streaming
- ✅ Infinite scroll pagination
- ✅ Conversation management
- ✅ Search and filter
Subscriptions
- ✅ RevenueCat integration
- ✅ Beautiful paywall UI
- ✅ Monthly and annual plans
- ✅ Entitlement checking
- ✅ Restore purchases
Design System
- ✅ 5 built-in themes
- ✅ Design tokens (colors, spacing, typography)
- ✅ 10+ UI components
- ✅ Dark mode support
- ✅ Accessibility built-in
Localization
- ✅ Type-safe strings with compile-time safety
- ✅ Automatic pluralization support
- ✅ 100+ pre-localized strings included
- ✅ English & Spanish out of the box
- ✅ Easy to add new languages
Accessibility
- ✅ 50+ pre-defined VoiceOver labels
- ✅ Dynamic Type support utilities
- ✅ Reduce Motion helpers
- ✅ High Contrast mode support
- ✅ Debug audit tools
Data Persistence
- ✅ SwiftData models (iOS 17+)
- ✅ Repository pattern
- ✅ Keychain for secrets
- ✅ Optional cloud sync
- ✅ Offline-first
Networking
- ✅ HTTP client with interceptors
- ✅ Automatic retry logic
- ✅ Auth token injection
- ✅ Request/response logging
- ✅ Error handling
Architecture
MVVM
Clean separation of concerns
Dependency Injection
CompositionRoot pattern
Protocol-Oriented
Swappable implementations
Async/Await
Modern concurrency
Modular
11 Swift Packages
Testable
~598 tests, CI-enforced coverage
Developer Experience
Testing
- ✅ ~598 tests across 12 package test targets + the app test suites
- ✅ One
Boilerplate.xctestplanrun covers the whole workspace - ✅
TestSupportpackage with shared infrastructure (URLProtocolStub) - ✅ CI/CD with GitHub Actions and coverage enforcement
- ✅ Mock implementations throughout
Documentation
- ✅ 60KB+ of guides
- ✅ 11 module docs
- ✅ Step-by-step setup & integration guides
- ✅ LLM prompts library
- ✅ Troubleshooting sections
Code Quality
- ✅ SwiftLint configured
- ✅ No force unwraps
- ✅ Files ≤ 400 lines
- ✅ Consistent patterns
- ✅ Comprehensive error handling
Optional Features
- Chat Sync
- Profile Photos
- Crashlytics
Cross-device conversation sync
- Offline-first
- Background sync
- Conflict resolution
- 22KB setup guide
Value Breakdown
Time Saved by Category
Cost Savings
At $100/hour:- Low: 276 hours × 27,600**
- High: 390 hours × 39,000**
What Makes This Special
AI-First Design
AI-First Design
- Architected for AI from day one
- Streaming (not batch)
- 500+ models (not locked in)
- Secure proxy included
Production-Ready
Production-Ready
- Not a demo
- ~598 tests with CI-enforced coverage
- Professional, localized error handling
- Security best practices and a Release-binary 4.3 audit gate
Best Practices
Best Practices
- MVVM done right
- Proper DI (not singletons)
- Protocol-oriented
- Modern concurrency
Documentation
Documentation
- Comprehensive documentation
- Step-by-step setup instructions
- LLM prompts included
- Code examples everywhere
Modular
Modular
- 11 independent packages
- Clear boundaries
- No circular dependencies
- Easy to extend
Related Resources
Architecture
System design overview
Modules
Module documentation
Building Guide
Customization guide, included in your boilerplate
Changelog
Version history
Quick Links
Core
Foundation utilities
Networking
HTTP client
Storage
SwiftData + Keychain
Auth
Authentication
Payments
Subscriptions
AI
LLM integration
FeatureChat
Chat UI
Settings
Settings + Paywall
DesignSystem
UI tokens
Localization
i18n + Type-safe strings
Accessibility
VoiceOver + Dynamic Type
