Skip to main content

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) playbookscripts/appstore-43-audit.sh runs a Release-binary strings audit that fails the build while un-rebranded starter fingerprints (SwiftAI, Boilerplate, the SAI design-system prefix), the starter BrandConfig.appDisplayName, placeholder legal URLs, or the starter bundle ID remain. Paired with docs/checklists/APP_STORE_4_3_HARDENING.md and prompt packs in docs/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 by scripts/validate-template-manifest.sh.
  • Hero archetype recipesdocs/recipes/hero/ ships DashboardGrid, FeedTimeline, MapCanvas, GuidedTaskFlow, and ConversationalHome, plus onboarding/paywall/feature recipes. 4.3 differentiation comes from mandatory archetype selection, not randomness.
  • TestSupport package + single workspace test plan — a test-only infrastructure package (URLProtocolStub) feeds Boilerplate.xctestplan, which runs ~598 tests across 12 package test targets + the app test suites in one xcodebuild test.
  • Localized error surfaceAppError.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_ID in Config/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 (no https://api.example.com fallback), and account deletion via AccountDeletionClient + a supabase/functions/delete-account/ Edge Function template.

Still current from v2.0

  • iOS 26 Liquid Glass via SAIGlass primitive, with automatic Material fallback on iOS 17–25
  • Swift 6 strict concurrency across every package
  • @MainActor-pinned storage repositories and @Observable view 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
See the v1.9 → v2.0 migration guide and the full changelog.
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.md for agentic development with Claude Code
  • ✅ 6 comprehensive Cursor AI .mdc rule 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
Time saved: 2-3x faster development with consistent quality

Authentication

  • ✅ Email/password via Supabase
  • ✅ Sign in with Apple and/or Google, via Supabase
  • ✅ Automatic token refresh
  • ✅ Secure Keychain storage
  • ✅ DEBUG-only MockAuthClient for development
Time saved: 20-32 hours

AI Integration

  • ✅ Streaming chat responses
  • ✅ 500+ models via OpenRouter
  • ✅ Secure Edge Function proxy (ProxyLLMClientsupabase/functions/ai/; key stays server-side)
  • ✅ Cancellable requests
  • EchoLLMClient dev fallback when PROXY_BASE_URL is empty
  • ✅ Easily replaceable with your own APIs
Time saved: 24-40 hours

Chat UI

  • ✅ Dual UI styles (bubble + centered)
  • ✅ Real-time streaming
  • ✅ Infinite scroll pagination
  • ✅ Conversation management
  • ✅ Search and filter
Time saved: 40-60 hours

Subscriptions

  • ✅ RevenueCat integration
  • ✅ Beautiful paywall UI
  • ✅ Monthly and annual plans
  • ✅ Entitlement checking
  • ✅ Restore purchases
Time saved: 16-24 hours

Design System

  • ✅ 5 built-in themes
  • ✅ Design tokens (colors, spacing, typography)
  • ✅ 10+ UI components
  • ✅ Dark mode support
  • ✅ Accessibility built-in
Time saved: 20-32 hours

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
Time saved: 12-16 hours

Accessibility

  • ✅ 50+ pre-defined VoiceOver labels
  • ✅ Dynamic Type support utilities
  • ✅ Reduce Motion helpers
  • ✅ High Contrast mode support
  • ✅ Debug audit tools
Time saved: 14-18 hours

Data Persistence

  • ✅ SwiftData models (iOS 17+)
  • ✅ Repository pattern
  • ✅ Keychain for secrets
  • ✅ Optional cloud sync
  • ✅ Offline-first
Time saved: 16-24 hours

Networking

  • ✅ HTTP client with interceptors
  • ✅ Automatic retry logic
  • ✅ Auth token injection
  • ✅ Request/response logging
  • ✅ Error handling
Time saved: 12-20 hours

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
Time saved: 30-40 hours

Developer Experience

Testing

  • ✅ ~598 tests across 12 package test targets + the app test suites
  • ✅ One Boilerplate.xctestplan run covers the whole workspace
  • TestSupport package with shared infrastructure (URLProtocolStub)
  • ✅ CI/CD with GitHub Actions and coverage enforcement
  • ✅ Mock implementations throughout
Time saved: 32-40 hours

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

Cross-device conversation sync
  • Offline-first
  • Background sync
  • Conflict resolution
  • 22KB setup guide
Enable when needed - feature flag controlled

Value Breakdown

Time Saved by Category

Cost Savings

At $100/hour:
  • Low: 276 hours × 100=100 = **27,600**
  • High: 390 hours × 100=100 = **39,000**

What Makes This Special

  • Architected for AI from day one
  • Streaming (not batch)
  • 500+ models (not locked in)
  • Secure proxy included
  • Not a demo
  • ~598 tests with CI-enforced coverage
  • Professional, localized error handling
  • Security best practices and a Release-binary 4.3 audit gate
  • MVVM done right
  • Proper DI (not singletons)
  • Protocol-oriented
  • Modern concurrency
  • Comprehensive documentation
  • Step-by-step setup instructions
  • LLM prompts included
  • Code examples everywhere
  • 11 independent packages
  • Clear boundaries
  • No circular dependencies
  • Easy to extend

Architecture

System design overview

Modules

Module documentation

Building Guide

Customization guide, included in your boilerplate

Changelog

Version history

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