Skip to main content
Complete guide: This page is the web version. For the deeper prompt library, see docs/BUILDING_YOUR_APP.md in your project.
Before you submit: Run the App Store 4.3 hardening checklist. Branded boilerplates get flagged when the binary, listing, and screenshots still look like the template. Five passes, one prompt, ~1 hour.

​
What This Guide Covers

This is your complete roadmap from boilerplate to App Store:

Branding

Name, icon, colors, onboarding

Backend

Supabase, RevenueCat, API keys

Features

Customize chat, home, profile, settings

Legal

Privacy, terms, compliance

Testing

Run tests, fix bugs

Launch

App Store submission

​
Two Ways to Use This Guide

Step-by-step instructions with exact file paths:
  • What to change
  • Where to find it
  • How to verify it works
  • What to test
Time: Detailed, thorough approach
Prefer a guided, automated path? The App Generator is a separate, standalone macOS product (coming soon) that drives your own coding-agent CLI to scaffold a differentiated, App Store Guideline 4.3-safe app from this template. It is not bundled in the boilerplate. See license & pricing for details.

​
Quick Examples

​
Change App Name

Manual:
  1. Set the user-facing name in BrandConfig.appDisplayName (Packages/DesignSystem/Sources/DesignSystem/Tokens/BrandConfig.swift)
  2. Set the app identity in APP_BUNDLE_ID in Config/App.xcconfig — every target’s bundle ID and app-group entitlements derive from this single value
AI Prompt:

​
Customize Colors

Manual:
  1. Open SwiftAIBoilerplatePro/Resources/DesignSystemColors.xcassets and edit Primary.colorset
  2. Edit the accent color in SwiftAIBoilerplatePro/Assets.xcassets/AccentColor.colorset
  3. Test in light/dark mode
AI Prompt:

​
Complete Guide Contents

​
Initial Setup

  • Clone and run
  • Change branding
  • Customize onboarding

​
Backend

  • Supabase deployment
  • RevenueCat setup
  • API configuration

​
Feature Customization

  • Home screen
  • Chat experience
  • Profile
  • Settings
  • Add new features
  • Privacy policy
  • Terms of service
  • App Store requirements

​
Testing & Launch

  • Run test suite
  • TestFlight beta
  • App Store submission
  • Production checklist

​
LLM Prompts Library

Ready-to-use prompts throughout the guide for:
  • Branding changes
  • UI customization
  • Feature additions
  • Backend setup
  • Troubleshooting

​
Quick Start Path

1

Phase 1: Setup

Clone → Run → Understand architecture
2

Phase 2: Branding

Name → Icon → Colors → Onboarding
3

Phase 3: Backend

Supabase → RevenueCat → Test real auth
4

Phase 4: Customize

Home → Chat → Your unique features
5

Phase 5: Legal

Update policies → Add required disclosures
6

Phase 6: Launch

Test → App Store assets → 4.3 hardening → Submit

​
View Complete Guide

View Complete Building Guide

Comprehensive guide with manual steps AND LLM prompts

Supabase Setup

Backend deployment

RevenueCat Setup

Subscription configuration

docs/CLAUDE.md

AI coding guidelines for assistants working in your project

Architecture

System design

​
Common Tasks

  • App name and bundle ID
  • App icon
  • Primary and accent colors
  • Onboarding content
  • Create SwiftData model
  • Create repository
  • Create ViewModel
  • Create View
  • Wire up in CompositionRoot
  • Edit hero section
  • Change feature cards
  • Modify quick actions
  • Update legal docs
  • Prepare App Store assets
  • Run full test suite
  • Archive and submit

​
Success Tips

For Manual Development:
  • Follow file paths exactly
  • Test after each change
  • Commit to git frequently
  • Use ⌘⇧F to search code
For AI-Assisted Development:
  • Always reference relevant docs in prompts
  • Review AI changes before running
  • Ask AI to verify changes compile
  • One feature at a time

​
Need Help?

The full guide adds a troubleshooting section, common pitfalls, per-phase verification steps, and pro tips. For the test workflow, see the Testing guide — one Boilerplate.xctestplan run covers ~598 tests across 12 package test targets plus the app test suites.