> ## Documentation Index
> Fetch the complete documentation index at: https://docs.swiftaiboilerplate.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Features Overview

> Complete inventory of what's included in SwiftAI Boilerplate Pro v2.2.0.

## 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.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 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.
* ✅ **`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 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_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](/pages/migration/v1-9-to-v2-0) and the [full changelog](/pages/reference/changelog).

<Note>
  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](/pages/reference/license) for the full model.
</Note>

## 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 (`ProxyLLMClient` → `supabase/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

<CardGroup cols={3}>
  <Card title="MVVM" icon="diagram-project">
    Clean separation of concerns
  </Card>

  <Card title="Dependency Injection" icon="plug">
    CompositionRoot pattern
  </Card>

  <Card title="Protocol-Oriented" icon="swap">
    Swappable implementations
  </Card>

  <Card title="Async/Await" icon="bolt">
    Modern concurrency
  </Card>

  <Card title="Modular" icon="cubes">
    11 Swift Packages
  </Card>

  <Card title="Testable" icon="flask">
    \~598 tests, CI-enforced coverage
  </Card>
</CardGroup>

**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

<Tabs>
  <Tab title="Chat Sync">
    **Cross-device conversation sync**

    * Offline-first
    * Background sync
    * Conflict resolution
    * 22KB setup guide

    **Enable when needed** - feature flag controlled
  </Tab>

  <Tab title="Profile Photos">
    **Cloud photo storage**

    * Supabase Storage
    * Automatic compression
    * Cross-device sync
    * 12KB setup guide

    **Enable when needed** - optional configuration
  </Tab>

  <Tab title="Crashlytics">
    **Error reporting**

    * Firebase integration
    * User opt-in
    * Protocol-based
    * Privacy-first

    **Enable when needed** - optional dependency
  </Tab>
</Tabs>

## Value Breakdown

### Time Saved by Category

| Category       | Hours       | What's Included                               |
| -------------- | ----------- | --------------------------------------------- |
| Architecture   | 20-32       | Modular packages, DI, MVVM                    |
| Authentication | 20-32       | Supabase + Apple Sign In                      |
| AI Integration | 24-40       | Streaming, proxy, 500+ models                 |
| Chat UI        | 40-60       | Two interfaces, pagination                    |
| Subscriptions  | 16-24       | RevenueCat, paywall UI                        |
| Design System  | 20-32       | Tokens, components, themes                    |
| Localization   | 12-16       | Type-safe strings, pluralization, 2 languages |
| Accessibility  | 14-18       | VoiceOver, Dynamic Type, Reduce Motion        |
| Data Layer     | 16-24       | SwiftData, repositories                       |
| Networking     | 12-20       | HTTP client, interceptors                     |
| Testing        | 20-32       | \~598 tests, single test plan, CI/CD          |
| Backend        | 20-32       | Edge Function, migrations                     |
| Best Practices | 32-40       | Patterns, security, performance               |
| **TOTAL**      | **276-390** | **Complete production app**                   |

### Cost Savings

**At \$100/hour:**

* Low: 276 hours × $100 = **$27,600\*\*
* High: 390 hours × $100 = **$39,000\*\*

## What Makes This Special

<AccordionGroup>
  <Accordion title="AI-First Design">
    * Architected for AI from day one
    * Streaming (not batch)
    * 500+ models (not locked in)
    * Secure proxy included
  </Accordion>

  <Accordion title="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
  </Accordion>

  <Accordion title="Best Practices">
    * MVVM done right
    * Proper DI (not singletons)
    * Protocol-oriented
    * Modern concurrency
  </Accordion>

  <Accordion title="Documentation">
    * Comprehensive documentation
    * Step-by-step setup instructions
    * LLM prompts included
    * Code examples everywhere
  </Accordion>

  <Accordion title="Modular">
    * 11 independent packages
    * Clear boundaries
    * No circular dependencies
    * Easy to extend
  </Accordion>
</AccordionGroup>

## Related Resources

<CardGroup cols={2}>
  <Card title="Architecture" href="/pages/architecture">
    System design overview
  </Card>

  <Card title="Modules" href="/pages/modules/core">
    Module documentation
  </Card>

  <Card title="Building Guide" href="https://github.com/SwiftAIBoilerplatePro/SwiftAIBoilerplatePro-Distribution/blob/main/docs/BUILDING_YOUR_APP.md">
    Customization guide, included in your boilerplate
  </Card>

  <Card title="Changelog" href="/pages/reference/changelog">
    Version history
  </Card>
</CardGroup>

## Quick Links

<CardGroup cols={3}>
  <Card title="Core" href="/pages/modules/core">
    Foundation utilities
  </Card>

  <Card title="Networking" href="/pages/modules/networking">
    HTTP client
  </Card>

  <Card title="Storage" href="/pages/modules/storage">
    SwiftData + Keychain
  </Card>

  <Card title="Auth" href="/pages/modules/auth">
    Authentication
  </Card>

  <Card title="Payments" href="/pages/modules/payments">
    Subscriptions
  </Card>

  <Card title="AI" href="/pages/modules/ai">
    LLM integration
  </Card>

  <Card title="FeatureChat" href="/pages/modules/feature-chat">
    Chat UI
  </Card>

  <Card title="Settings" href="/pages/modules/feature-settings">
    Settings + Paywall
  </Card>

  <Card title="DesignSystem" href="/pages/modules/design-system">
    UI tokens
  </Card>

  <Card title="Localization" href="/pages/modules/localization">
    i18n + Type-safe strings
  </Card>

  <Card title="Accessibility" href="/pages/modules/accessibility">
    VoiceOver + Dynamic Type
  </Card>
</CardGroup>