aj/XCode-Claude-Workflow
1
0
Fork 0
Code Issues Pull requests Actions Packages Projects Releases Wiki Activity
Claude Code + Xcode workflow for App Store-ready iOS/macOS app development
6 commits 1 branch 0 tags 1.8 MiB
Shell 100%
Find a file
idev2025 63377d3ddf feat: add setup.sh and xcode.gitignore for app repo initialization 
setup.sh copies PROMPT.md and .gitignore into a new app repo with one command.
xcode.gitignore covers Xcode, SPM, CocoaPods, code signing, and secrets.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-15 22:05:18 -04:00
.gitignore chore: gitignore Xcode/Swift files to keep template clean 2026-04-14 08:31:00 -04:00
CHANGELOG.md refactor: clean template repo — move SoliCards to its own repo 2026-04-14 08:28:25 -04:00
CLAUDE.md refactor: clean template repo — move SoliCards to its own repo 2026-04-14 08:28:25 -04:00
INSTRUCTIONS.md docs: add step-by-step instructions for converting web apps 2026-04-14 22:06:01 -04:00
PROMPT.md feat: SoliCards v1.2.0 — native SwiftUI solitaire for iOS, iPadOS, macOS 2026-04-14 07:33:52 -04:00
README.md refactor: clean template repo — move SoliCards to its own repo 2026-04-14 08:28:25 -04:00
setup.sh feat: add setup.sh and xcode.gitignore for app repo initialization 2026-04-15 22:05:18 -04:00
xcode.gitignore feat: add setup.sh and xcode.gitignore for app repo initialization 2026-04-15 22:05:18 -04:00

README.md

XCode-Claude-Workflow

A structured 8-phase workflow for building App Store-ready iOS/macOS applications using Xcode + Claude Code.

What This Is

A methodology prompt (PROMPT.md) that guides Claude Code through transforming existing code — prototypes, web apps, partial implementations — into production-quality native Apple applications.

How to Use

  1. Clone this repo
  2. Point Claude Code to your existing code folder
  3. Paste or reference PROMPT.md as the task prompt
  4. Follow the 8 phases: Audit → Architecture → Implementation → Persistence → Accessibility → Quality → App Store → Documentation

Phases

# Phase What Happens
0 Codebase Intake Read every file, produce audit report, confirm platform
1 Architecture Propose pattern (MVVM/TCA), scaffold Xcode project
2 Core Features Implement one feature at a time with tests
3 Data & Persistence SwiftData, networking, error states
4 Accessibility VoiceOver, Dynamic Type, localization
5 Performance Instruments profiling, 70%+ test coverage
6 App Store Prep Privacy manifest, icons, archive, metadata
7 Documentation SETUP.md, CHANGELOG.md, ARCHITECTURE.md

Example

This workflow was used to build SoliCards-iOS-iPadOS-MacOS — a solitaire card game ported from JavaScript to native SwiftUI for iOS, iPadOS, and macOS.