Configuration Files
Config/Secrets.xcconfig
Location: Config/Secrets.xcconfig (gitignored)
This file contains API keys and secrets. Never commit to git!
Config/Secrets.example.xcconfig
# Supabase Configuration
SUPABASE_URL = https://your-project-ref.supabase.co
SUPABASE_ANON_KEY = YOUR_PUBLIC_ANON_KEY
# RevenueCat Configuration
REVENUECAT_API_KEY = YOUR_RC_KEY
RC_ENTITLEMENT_ID = pro
# AI Proxy Configuration
PROXY_BASE_URL = https://your-project-ref.supabase.co/functions/v1
PROXY_PATH = /ai
Config/App.xcconfig
Location: Config/App.xcconfig
General app configuration:
# App Identity
PRODUCT_NAME = SwiftAIBoilerplatePro
PRODUCT_BUNDLE_IDENTIFIER = com.yourcompany.yourapp
MARKETING_VERSION = 1.0.0
CURRENT_PROJECT_VERSION = 1
# Deployment Target
IPHONEOS_DEPLOYMENT_TARGET = 17.0
# Build Settings
SWIFT_VERSION = 5.10
Environment Variables
Development (DEBUG builds)
Set in Xcode Scheme → Edit Scheme → Run → Arguments → Environment Variables:
| Variable | Default | Purpose |
|---|
AUTH_BYPASS | 1 (enabled) | Enable MockAuthClient |
CHAT_SYNC_ENABLED | false | Enable chat sync |
CRASH_REPORTING_ENABLED | false | Enable Crashlytics |
Production (RELEASE builds)
Controlled by FeatureFlags.swift:
| Feature | Default | Notes |
|---|
| Mock Auth | false | Always disabled in RELEASE |
| Chat Sync | Feature flag | Optional cloud sync |
| Crashlytics | true | Error reporting |
Feature Flags
Location: SwiftAIBoilerplatePro/Composition/FeatureFlags.swift
public enum FeatureFlags {
// Mock Auth (DEBUG only)
public static var shouldUseMock: Bool {
#if DEBUG
return ProcessInfo.processInfo.environment["AUTH_BYPASS"] != "0"
#else
return false
#endif
}
// Chat Sync (Optional)
public static var chatSyncEnabled: Bool {
#if DEBUG
return true // Set to true to enable
#else
return ProcessInfo.processInfo.environment["CHAT_SYNC_ENABLED"] == "true"
#endif
}
// Crashlytics
public static var crashlyticsEnabled: Bool {
#if DEBUG
return false
#else
return true
#endif
}
}
Backend Configuration
Supabase
SUPABASE_URL = https://dev-project.supabase.co
SUPABASE_ANON_KEY = dev_anon_key
PROXY_BASE_URL = https://dev-project.supabase.co/functions/v1
OpenRouter
Set as Supabase secret:
supabase secrets set OPENROUTER_API_KEY=sk-or-v1-YOUR_KEY
RevenueCat
REVENUECAT_API_KEY = appl_YOUR_PUBLIC_KEY
RC_ENTITLEMENT_ID = pro
CompositionRoot Configuration
Location: SwiftAIBoilerplatePro/Composition/CompositionRoot.swift
The DI container reads configuration and creates appropriate implementations:
// Reads from Config/Secrets.xcconfig
let supabaseURL = ProcessInfo.processInfo.environment["SUPABASE_URL"]
let proxyBaseURL = ProcessInfo.processInfo.environment["PROXY_BASE_URL"]
// Chooses implementation based on config
if shouldUseMock {
self.sessionManager = MockAuthClient()
} else {
self.sessionManager = SupabaseAuthClient(...)
}
if proxyBaseURL?.isEmpty == false {
self.llmClient = ProxyLLMClient(...)
} else {
self.llmClient = EchoLLMClient()
}
Xcode Build Configuration
Debug vs Release
Debug (default):
- Mock auth enabled by default
- Detailed logging
- Crashlytics disabled
- No optimization
Release:
- Real auth required
- Production logging
- Crashlytics enabled
- Full optimization
Switch configuration:
Product → Scheme → Edit Scheme → Run → Build Configuration
Quick Reference
Enable Real Auth in DEBUG
- Edit Scheme → Run → Environment Variables
- Add
AUTH_BYPASS = 0
- Configure Supabase in
Secrets.xcconfig
- Clean and rebuild
- Run SQL migration
- Set
chatSyncEnabled = true in FeatureFlags
- Uncomment Supabase repositories
- Wire up in CompositionRoot
Switch to Production Backend
- Update
Secrets.xcconfig with production URLs/keys
- Verify in RELEASE build configuration
- Archive and test
