> ## 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.

# Welcome to SwiftAI Boilerplate Pro

> Swift 6 + iOS 26 Liquid Glass iOS boilerplate for AI-powered apps. Streaming chat, Supabase auth, RevenueCat subscriptions, and 11 clean Swift Packages.

**Ship your AI-powered iOS app in days, not months.**

SwiftAI Boilerplate Pro is a production-ready iOS foundation built by an iOS engineer with 10 years of commercial experience, who has shipped multiple production apps. It includes everything you need to build and launch AI chat applications with authentication, subscriptions, and analytics out of the box.

<Note>
  **v2.2.0 is live: the App Store Guideline 4.3(a) playbook** — a Release-binary audit gate plus hardening checklist and prompt packs that fail your build until the app is rebranded and 4.3-safe. Requires Xcode 26.2+. See the [changelog](/pages/reference/changelog) and the [migration guide](/pages/migration/v1-9-to-v2-0).
</Note>

<Note>
  All setup, integration, and publishing steps are explained here on these docs. For customization and design patterns, see the corresponding files under /docs in your project.
</Note>

<Info>
  **App Generator is a separate product (coming soon).** A standalone macOS app that drives your own coding-agent CLI to generate a differentiated, 4.3-safe app from this template — it ships no LLM and is sold separately. Existing and past buyers are grandfathered: lifetime access to all new boilerplate versions (v2.2.0 and beyond, no new charge), plus App Generator access when it ships. See the [license & updates model](/pages/reference/license) for the full breakdown.
</Info>

<Tip>
  **Found an issue or confusing setup step?** Please open a [GitHub issue](https://github.com/SwiftAIBoilerplatePro/SwiftAIBoilerplatePro-Distribution/issues). Include your Xcode version, Swift version, boilerplate tag or branch, the exact error text, and the steps you took so we can reproduce it quickly.
</Tip>

## What You Get

<CardGroup cols={2}>
  <Card title="App Store 4.3(a) Playbook" icon="shield-check" href="/pages/guides/app-store-4-3-hardening">
    Release-binary audit gate, hardening checklist, and prompt packs that keep your app 4.3-safe
  </Card>

  <Card title="AI-Assisted Development" icon="wand-magic-sparkles" href="/pages/guides/ai-assisted-development">
    Claude Code, Cursor AI, and Bolt AI configurations included
  </Card>

  <Card title="AI Chat" icon="message" href="/pages/modules/ai">
    Streaming responses via OpenRouter (500+ models)
  </Card>

  <Card title="Authentication" icon="lock" href="/pages/modules/auth">
    Supabase Auth + Sign in with Apple, ready to go
  </Card>

  <Card title="Subscriptions" icon="credit-card" href="/pages/modules/payments">
    RevenueCat integration with paywall UI
  </Card>

  <Card title="Design System" icon="palette" href="/pages/modules/design-system">
    5 themes, tokens, and components
  </Card>

  <Card title="~598 Tests" icon="flask" href="/pages/guides/testing">
    \~598 tests across 12 package test targets + the app test suites, in one test-plan run
  </Card>
</CardGroup>

## Quick Stats

* **275+ hours** of development already done
* **\~598 tests** across 12 package test targets + the app test suites, in one test-plan run
* **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)

## Time Saved

<Info>
  This boilerplate typically saves **5-8 weeks** of build time and $20,000-$30,000 in development cost compared to building from scratch.

  Module savings are conservative estimates based on prior builds; your mileage may vary by scope and team experience.
</Info>

See the complete feature breakdown in [Features Reference](/pages/reference/features).

## Get Started in 3 Steps

<Steps>
  <Step title="Installation">
    Clone the repo and run the app with mock backends

    [View Installation Guide →](/pages/installation)
  </Step>

  <Step title="Quick Start">
    Go from zero to a running app in 10 minutes

    [View Quick Start →](/pages/quickstart)
  </Step>

  <Step title="Customize">
    Follow the in-doc customization roadmap, then use the deeper files in your project’s `/docs` folder when you need more detail.

    [View Building Your App →](/pages/guides/building-your-app)
  </Step>
</Steps>

## Production Setup Order

After the mock app runs, use this sequence to connect real services:

| Step | Goal                                    | Guide                                                                                                                                                                            |
| ---- | --------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 1    | Create Supabase project and secrets     | [Supabase Setup](/pages/guides/supabase-setup)                                                                                                                                   |
| 2    | Configure Apple, Google, and email auth | [Authentication Guide](/pages/guides/authentication)                                                                                                                             |
| 3    | Deploy the OpenRouter AI proxy          | [Deployment Guide](/pages/guides/deployment#openrouter-setup)                                                                                                                    |
| 4    | Set up subscriptions and entitlements   | [RevenueCat Setup](/pages/guides/revenuecat-setup)                                                                                                                               |
| 5    | Add optional services                   | [Crashlytics](/pages/guides/crashlytics-setup), [OneSignal](/pages/guides/onesignal-setup), [Chat Sync](/pages/guides/chat-sync), [Profile Photos](/pages/guides/profile-photos) |
| 6    | Prepare App Store submission            | [App Store 4.3 Hardening](/pages/guides/app-store-4-3-hardening)                                                                                                                 |

## Architecture Overview

Built with modern iOS development best practices:

* **Swift 6 strict concurrency** - `@MainActor`, `@Observable`, explicit `any`, Sendable boundaries
* **iOS 26 Liquid Glass** - `SAIGlass` primitive with automatic Material fallback on iOS 17–25
* **MVVM Architecture** - Clean separation of concerns
* **Dependency Injection** - CompositionRoot pattern
* **Protocol-Oriented** - Swappable implementations
* **SwiftData** - Modern persistence (iOS 17+)

[Learn about the architecture →](/pages/architecture)

## Foundation Modules

<CardGroup cols={3}>
  <Card title="Core" icon="cube" href="/pages/modules/core">
    Error handling, logging, utilities

    **Saves: 6–10 hrs**
  </Card>

  <Card title="Networking" icon="wifi" href="/pages/modules/networking">
    HTTP client with interceptors

    **Saves: 12-20 hrs**
  </Card>

  <Card title="Storage" icon="database" href="/pages/modules/storage">
    SwiftData + Keychain + Cloud sync

    **Saves: 16-24 hrs**
  </Card>

  <Card title="Auth" icon="shield" href="/pages/modules/auth">
    Supabase + Apple + Google + Email

    **Saves: 20-32 hrs**
  </Card>

  <Card title="Subscriptions" icon="dollar" href="/pages/modules/payments">
    RevenueCat subscriptions

    **Saves: 16-24 hrs**
  </Card>

  <Card title="AI" icon="brain" href="/pages/modules/ai">
    LLM client with streaming

    **Saves: 24-40 hrs**
  </Card>

  <Card title="Feature Chat" icon="comments" href="/pages/modules/feature-chat">
    Complete chat UI (2 styles)

    **Saves: 40-60 hrs**
  </Card>

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

    **Saves: 12-16 hrs**
  </Card>

  <Card title="Design System" icon="swatchbook" href="/pages/modules/design-system">
    Design tokens, 5 themes, and components

    **Saves: 20-32 hrs**
  </Card>
</CardGroup>

## Next Steps

<CardGroup cols={2}>
  <Card title="Install" icon="download" href="/pages/installation">
    Get the boilerplate running locally
  </Card>

  <Card title="Quick Start" icon="bolt" href="/pages/quickstart">
    10-minute guide to first run
  </Card>

  <Card title="Architecture" icon="diagram-project" href="/pages/architecture">
    Understand the system design
  </Card>

  <Card title="Build Your App" icon="hammer" href="/pages/guides/building-your-app">
    Complete customization guide
  </Card>
</CardGroup>

## Need Help?

* [Complete Documentation Hub](https://github.com/SwiftAIBoilerplatePro/SwiftAIBoilerplatePro-Distribution/blob/main/docs/INDEX.md)
* [GitHub Issues](https://github.com/SwiftAIBoilerplatePro/SwiftAIBoilerplatePro-Distribution/issues)
* Use the built-in [CLAUDE.md](https://github.com/SwiftAIBoilerplatePro/SwiftAIBoilerplatePro-Distribution/blob/main/docs/CLAUDE.md) guide for AI-assisted development