Asc Publish

Publish to App Store Connect

Archive, create IPA, and upload to App Store Connect.

Arguments: $ARGUMENTS

• (none): Full build and upload
• --skip-upload: Build only, don't upload

Quick Start

# Full build and upload
.claude/skills/asc-publish/scripts/publish_appstore.sh

# Build only (skip upload)
SKIP_UPLOAD=1 .claude/skills/asc-publish/scripts/publish_appstore.sh

What It Does

1. Queries App Store Connect for latest build number
2. Archives with xcodebuild archive using build number + 1
3. Creates IPA from archive
4. Uploads via iTMSTransporter

No local project file changes needed! Build number is determined from ASC and passed to xcodebuild at build time.

Prerequisites

1. Transporter App

Install from Mac App Store: Transporter

2. Distribution Certificate

• Open Xcode → Settings → Accounts
• Select Apple ID → Manage Certificates
• Create "Apple Distribution" certificate

3. App Store Connect API Key

1. Go to App Store Connect API Keys
2. Create a new key with "App Manager" access
3. Download the .p8 file (only available once!)
4. Note the Key ID and Issuer ID

4. Configure Credentials

Automatic (recommended): If you've already run asc auth login, credentials are stored in the macOS Keychain. The script auto-resolves them using the default_key_name from .asc/config.json. No extra setup needed.

Manual (fallback): Create .asc/publish.env:

mkdir -p .asc
cat > .asc/publish.env << 'EOF'
APP_STORE_CONNECT_API_KEY=YOUR_KEY_ID
APP_STORE_CONNECT_API_ISSUER=YOUR_ISSUER_ID
APP_STORE_CONNECT_API_PRIVATE_KEY_PATH=./AuthKey_YOUR_KEY_ID.p8
APP_STORE_CONNECT_API_KEY_TYPE=individual
EOF

Copy your .p8 key file to .asc/:

cp ~/Downloads/AuthKey_XXXXX.p8 .asc/

Worktree Support

The script works from git worktrees automatically:

• Falls back to the main worktree for .asc/config.json and .asc/publish.env
• Auto-resolves credentials from asc CLI keychain if no publish.env exists

Usage

Full Build & Upload

.claude/skills/asc-publish/scripts/publish_appstore.sh

Build Only (Test)

SKIP_UPLOAD=1 .claude/skills/asc-publish/scripts/publish_appstore.sh

Output

Using team ID: 58MYNHGN72
Incrementing build number...
Build number set to: 15
Archiving IngrediCheck...
Creating IPA from archive...
IPA created at build/AppStoreExport/IngrediCheck.ipa
Uploading IPA via iTMSTransporter...
=========================================
Upload complete!
Build number: 15
Check App Store Connect for build status.
=========================================

After Upload

Once uploaded, the build will:

1. Process in App Store Connect (few minutes)
2. Appear in TestFlight
3. Be available for internal testers immediately
4. Require Beta App Review for external testers (if not already approved)

Check status with: /asc-builds

Troubleshooting

Config

Converted and distributed by TomeVault — claim your Tome and manage your conversions.