v2.0.0 is live: Swift 6 and iOS 26 Liquid Glass. Requires Xcode 26.2+. See the changelog and the migration guide.
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.
What You Get
AI-Assisted Development
Claude Code, Cursor AI, and Bolt AI configurations included
AI Chat
Streaming responses via OpenRouter (500+ models)
Authentication
Supabase Auth + Sign in with Apple, ready to go
Subscriptions
RevenueCat integration with paywall UI
Design System
5 themes, tokens, and components
338+ Tests
Comprehensive test coverage with mocks and async testing
Quick Stats
- 275+ hours of development already done
- 338+ tests with comprehensive coverage
- 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
This boilerplate typically saves 5-8 weeks of build time and 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.
Get Started in 3 Steps
Installation
Clone the repo and run the app with mock backendsView Installation Guide →
Quick Start
Go from zero to a running app in 10 minutesView Quick Start →
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 →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 |
| 2 | Configure Apple, Google, and email auth | Authentication Guide |
| 3 | Deploy the OpenRouter AI proxy | Deployment Guide |
| 4 | Set up subscriptions and entitlements | RevenueCat Setup |
| 5 | Add optional services | Crashlytics, OneSignal, Chat Sync, Profile Photos |
| 6 | Prepare App Store submission | App Store 4.3 Hardening |
Architecture Overview
Built with modern iOS development best practices:- Swift 6 strict concurrency -
@MainActor,@Observable, explicitany, Sendable boundaries - iOS 26 Liquid Glass -
SAIGlassprimitive 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+)
Foundation Modules
Core
Error handling, logging, utilitiesSaves: 6–10 hrs
Networking
HTTP client with interceptorsSaves: 12-20 hrs
Storage
SwiftData + Keychain + Cloud syncSaves: 16-24 hrs
Auth
Supabase + Apple + Google + EmailSaves: 20-32 hrs
Subscriptions
RevenueCat subscriptionsSaves: 16-24 hrs
AI
LLM client with streamingSaves: 24-40 hrs
Feature Chat
Complete chat UI (2 styles)Saves: 40-60 hrs
Settings
Settings + Paywall UISaves: 12-16 hrs
Design System
Design tokens, 5 themes, and componentsSaves: 20-32 hrs
Next Steps
Install
Get the boilerplate running locally
Quick Start
10-minute guide to first run
Architecture
Understand the system design
Build Your App
Complete customization guide
Need Help?
- Complete Documentation Hub
- GitHub Issues
- Use the built-in CLAUDE.md guide for AI-assisted development
