Feature Settings Module

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.

​

What’s new in v2.0

• SettingsView.swift is now a ≤ 125-line composition root. Every section lives in its own file under Views/Settings/*.swift (appearance, privacy, account, legal, and so on). The public entry point is unchanged; downstream customisations that used to edit one giant file now edit the matching section file.
• Paywall CTAs use the standard system styles: .buttonStyle(.borderedProminent) for the primary CTA and .bordered for the secondary. If you were styling paywall buttons via .background(), switch to .tint(YourColor) on the standard styles so Liquid Glass handles the surface correctly on iOS 26.
• Profile, EmailSignUp, and related screens were split the same way. Check the Views/ subfolders if a previous customisation disappears from the top-level file.

​

Purpose

• Settings UI - User preferences management
• Paywall - Beautiful subscription screen
• Theme Selection - 5 built-in themes
• Privacy Controls - Diagnostics, notifications
• Account Management - Sign out, delete account

​

Key Components

​

SettingsViewModel

@MainActor
@Observable
class SettingsViewModel {
    var currentTheme: UserThemePreference
    var shareDiagnostics: Bool
    var notificationsEnabled: Bool
    var isSubscribed: Bool
    
    func updateTheme(_ theme: UserThemePreference) async
    func toggleDiagnostics(_ enabled: Bool) async
    func signOut() async
}

​

PaywallViewModel

@MainActor
@Observable
class PaywallViewModel {
    var offerings: [PaymentsOffering]
    var isLoading: Bool
    var error: String?
    
    func purchase(productID: String) async
    func restorePurchases() async
}

​

Settings Categories

​

Paywall UI

• ✅ Feature comparison
• ✅ Pricing display
• ✅ Monthly and annual options
• ✅ Clear CTAs
• ✅ Terms and privacy links
• ✅ Restore purchases button

​

Customization Examples

​

Add New Setting

// 1. Add to Settings model
@Model
class Settings {
    var theme: UserThemePreference
    var shareDiagnostics: Bool
    var autoSaveChats: Bool  // New setting
}

// 2. Add to ViewModel
@Observable
class SettingsViewModel {
    var autoSaveChats: Bool
    
    func toggleAutoSave(_ enabled: Bool) async {
        autoSaveChats = enabled
        await settingsRepository.update(autoSaveChats: enabled)
    }
}

// 3. Add to UI
Toggle("Auto-save Chats", isOn: $viewModel.autoSaveChats)
    .onChange(of: viewModel.autoSaveChats) {
        Task { await viewModel.toggleAutoSave($0) }
    }

​

Customize Paywall

// In PaywallView, modify features list:
let proFeatures = [
    "Unlimited AI messages",
    "Access to GPT-4 and Claude",
    "Priority support",
    "Early access to features",
    "Custom AI personas"  // Add your feature
]

​

Add Custom Theme

// 1. Add color set in DesignSystemColors.xcassets
// 2. Add case to UserThemePreference
public enum UserThemePreference: String, Codable {
    case system, light, dark, aurora, obsidian
    case custom  // New theme
}

// 3. Update DSColors to map your theme
// 4. Add to theme picker in Settings

​

Paywall Best Practices

​

Key Files

​

Dependencies

• Core - Error handling, logging, theme types
• Payments - Subscription management
• DesignSystem - UI components

​

Used By

• Main App - Settings tab
• All features - Theme observation
• Profile - Subscription status

​

Best Practices

​

Learn More

​

Build with AI (fast)

​

Example Prompt

​

Test Coverage

• Settings persistence
• Theme switching
• Paywall display
• Purchase flows
• Error handling