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

# Building Your App

> Complete step-by-step customization guide from boilerplate to App Store

<Info>
  **Complete guide:** This page is the web version. For the deeper prompt library, see `docs/BUILDING_YOUR_APP.md` in your project.
</Info>

<Warning>
  **Before you submit:** Run the [App Store 4.3 hardening checklist](/pages/guides/app-store-4-3-hardening). Branded boilerplates get flagged when the binary, listing, and screenshots still look like the template. Five passes, one prompt, \~1 hour.
</Warning>

## What This Guide Covers

This is your **complete roadmap** from boilerplate to App Store:

<CardGroup cols={2}>
  <Card title="Branding" icon="palette">
    Name, icon, colors, onboarding
  </Card>

  <Card title="Backend" icon="server">
    Supabase, RevenueCat, API keys
  </Card>

  <Card title="Features" icon="puzzle-piece">
    Customize chat, home, profile, settings
  </Card>

  <Card title="Legal" icon="gavel">
    Privacy, terms, compliance
  </Card>

  <Card title="Testing" icon="flask">
    Run tests, fix bugs
  </Card>

  <Card title="Launch" icon="rocket">
    App Store submission
  </Card>
</CardGroup>

## Two Ways to Use This Guide

<Tabs>
  <Tab title="Manual (Traditional)">
    **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
  </Tab>

  <Tab title="AI-Assisted (Fast)">
    **Ready-to-use LLM prompts** for Cursor/Claude:

    * Copy prompt
    * Paste in AI assistant
    * AI makes the changes
    * You review and test

    **Time:** 3-5x faster
  </Tab>
</Tabs>

<Note>
  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](/pages/reference/license) for details.
</Note>

## 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:**

```text theme={null}
Change appDisplayName to "MyAwesomeApp" and APP_BUNDLE_ID to
"com.mycompany.myawesomeapp". Update all user-facing text.
```

### 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:**

```text theme={null}
Change primary color to #6C5CE7 (purple) and accent to #00D4AA (teal).
Update Primary.colorset in SwiftAIBoilerplatePro/Resources/DesignSystemColors.xcassets
and AccentColor.colorset in SwiftAIBoilerplatePro/Assets.xcassets, both for light and dark.
```

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

### Legal & Compliance

* 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

<Steps>
  <Step title="Phase 1: Setup">
    Clone → Run → Understand architecture
  </Step>

  <Step title="Phase 2: Branding">
    Name → Icon → Colors → Onboarding
  </Step>

  <Step title="Phase 3: Backend">
    Supabase → RevenueCat → Test real auth
  </Step>

  <Step title="Phase 4: Customize">
    Home → Chat → Your unique features
  </Step>

  <Step title="Phase 5: Legal">
    Update policies → Add required disclosures
  </Step>

  <Step title="Phase 6: Launch">
    Test → App Store assets → [4.3 hardening](/pages/guides/app-store-4-3-hardening) → Submit
  </Step>
</Steps>

## View Complete Guide

<Card title="View Complete Building Guide" icon="book" href="https://github.com/SwiftAIBoilerplatePro/SwiftAIBoilerplatePro-Distribution/blob/main/docs/BUILDING_YOUR_APP.md">
  Comprehensive guide with manual steps AND LLM prompts
</Card>

## Related Resources

<CardGroup cols={2}>
  <Card title="Supabase Setup" icon="server" href="/pages/guides/supabase-setup">
    Backend deployment
  </Card>

  <Card title="RevenueCat Setup" icon="dollar" href="/pages/guides/revenuecat-setup">
    Subscription configuration
  </Card>

  <Card title="docs/CLAUDE.md" icon="robot" href="https://github.com/SwiftAIBoilerplatePro/SwiftAIBoilerplatePro-Distribution/blob/main/docs/CLAUDE.md">
    AI coding guidelines for assistants working in your project
  </Card>

  <Card title="Architecture" icon="diagram-project" href="/pages/architecture">
    System design
  </Card>
</CardGroup>

## Common Tasks

<AccordionGroup>
  <Accordion title="Change App Branding">
    * App name and bundle ID
    * App icon
    * Primary and accent colors
    * Onboarding content
  </Accordion>

  <Accordion title="Add New Feature">
    * Create SwiftData model
    * Create repository
    * Create ViewModel
    * Create View
    * Wire up in CompositionRoot
  </Accordion>

  <Accordion title="Customize Home Screen">
    * Edit hero section
    * Change feature cards
    * Modify quick actions
  </Accordion>

  <Accordion title="Deploy to Production">
    * Update legal docs
    * Prepare App Store assets
    * Run full test suite
    * Archive and submit
  </Accordion>
</AccordionGroup>

## Success Tips

<Tip>
  **For Manual Development:**

  * Follow file paths exactly
  * Test after each change
  * Commit to git frequently
  * Use ⌘⇧F to search code
</Tip>

<Tip>
  **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
</Tip>

## Need Help?

The [full guide](https://github.com/SwiftAIBoilerplatePro/SwiftAIBoilerplatePro-Distribution/blob/main/docs/BUILDING_YOUR_APP.md) adds a troubleshooting section, common pitfalls, per-phase verification steps, and pro tips. For the test workflow, see the [Testing guide](/pages/guides/testing) — one `Boilerplate.xctestplan` run covers \~598 tests across 12 package test targets plus the app test suites.