Overview

This skill covers all essential development commands for working with this Tuist-based iOS project, including tool setup, project generation, building, and deployment workflows.

When to use

Use this skill when:

• •Setting up the development environment for the first time
• •Generating Xcode workspace after file changes (create, delete, rename)
• •Building or testing the project
• •Deploying to TestFlight or App Store
• •Working with encrypted secrets

Instructions

Project Overview

iOS educational app (공인중개사요약집) for Korean real estate agent certification exam preparation.

• •Target: iOS 18.0+ (Widget extension requires iOS 26.0+)
• •Swift: 5
• •Project: Tuist-generated workspace

Setup Tools

# Install mise and Tuist
brew install mise
mise install tuist

# Use tuist without mise prefix (optional)
eval "$(mise activate bash)"

Generate & Build

# Generate Xcode workspace (without opening)
mise x -- tuist generate --no-open

# Generate and open in Xcode
mise x -- tuist generate --open

# Build project
tuist build

# Test compilation (use generic iOS destination)
xcodebuild build -scheme App -workspace realtornote.xcworkspace -destination 'generic/platform=iOS'

# Clean build artifacts
tuist clean

IMPORTANT: Always regenerate after file changes:

• •✅ Created new file → mise x -- tuist generate --no-open
• •✅ Deleted file → mise x -- tuist generate --no-open
• •✅ Renamed file → mise x -- tuist generate --no-open
• •❌ Skip regeneration → Build errors ("cannot find in scope")

Secrets & Deployment

# Decrypt secrets (git-secret)
git secret reveal -p <password>

# Deploy to TestFlight
fastlane ios release description:'변경사항 설명' isReleasing:false

# Deploy to App Store
fastlane ios release description:'변경사항 설명' isReleasing:true

Key Reminders

• •Always regenerate Tuist project after creating, deleting, or renaming files
• •Use mise x -- prefix for Tuist commands if mise is not activated in shell
• •Generate project if you insert new file or rename using tuist