Skip to main content
Complete guide: See BUILDING_YOUR_APP.md in the project root

​
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

  • Manual (Traditional)
  • AI-Assisted (Fast)
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

​
Quick Examples

​
Change App Name

Manual:
  1. Open Config/App.xcconfig
  2. Change PRODUCT_NAME
  3. Update display strings
AI Prompt: 
Change app name to "MyAwesomeApp" and bundle ID to 
"com.mycompany.myawesomeapp". Update all user-facing text.

​
Customize Colors

Manual:
  1. Open DesignSystemColors.xcassets
  2. Edit Primary.colorset
  3. Test in light/dark mode
AI Prompt: 
Change primary color to #6C5CE7 (purple) and accent to #00D4AA 
(teal). Update in DesignSystemColors.xcassets for both 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
  • Privacy policy
  • Terms of service
  • App Store requirements

​
Testing & Launch

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

​
LLM Prompts Library

50+ ready-to-use prompts 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 → Submit

​
View Complete Guide

View Complete Building Guide

Comprehensive guide with manual steps AND LLM prompts

Supabase Setup

Backend deployment

RevenueCat Setup

Subscription configuration

CLAUDE.md

AI coding guideline in your project root

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 includes:
  • ✅ Complete troubleshooting section
  • ✅ Common pitfalls to avoid
  • ✅ Verification steps for each phase
  • ✅ Example timelines
  • ✅ Pro tips throughout
⌘I