SpeechToText - macOS App

A modern macOS application using a workspace + SPM package architecture for clean separation between app shell and feature code.

Project Architecture

SpeechToText/
├── SpeechToText.xcworkspace/              # Open this file in Xcode
├── SpeechToText.xcodeproj/                # App shell project
├── SpeechToText/                          # App target (minimal)
│   ├── Assets.xcassets/                # App-level assets (icons, colors)
│   ├── SpeechToTextApp.swift              # App entry point
│   ├── SpeechToText.entitlements          # App sandbox settings
│   └── SpeechToText.xctestplan            # Test configuration
├── SpeechToTextPackage/                   # 🚀 Primary development area
│   ├── Package.swift                   # Package configuration
│   ├── Sources/SpeechToTextFeature/       # Your feature code
│   └── Tests/SpeechToTextFeatureTests/    # Unit tests
└── SpeechToTextUITests/                   # UI automation tests

Key Architecture Points

Workspace + SPM Structure

• App Shell: SpeechToText/ contains minimal app lifecycle code
• Feature Code: SpeechToTextPackage/Sources/SpeechToTextFeature/ is where most development happens
• Separation: Business logic lives in the SPM package, app target just imports and displays it

Buildable Folders (Xcode 16)

• Files added to the filesystem automatically appear in Xcode
• No need to manually add files to project targets
• Reduces project file conflicts in teams

App Sandbox

The app is sandboxed by default with basic file access permissions. Modify SpeechToText.entitlements to add capabilities as needed.

Development Notes

Code Organization

Most development happens in SpeechToTextPackage/Sources/SpeechToTextFeature/ - organize your code as you prefer.

Public API Requirements

Types exposed to the app target need public access:

public struct SettingsView: View {
    public init() {}

    public var body: some View {
        // Your view code
    }
}

Adding Dependencies

Edit SpeechToTextPackage/Package.swift to add SPM dependencies:

dependencies: [
    .package(url: "https://github.com/example/SomePackage", from: "1.0.0")
],
targets: [
    .target(
        name: "SpeechToTextFeature",
        dependencies: ["SomePackage"]
    ),
]

Test Structure

• Unit Tests: SpeechToTextPackage/Tests/SpeechToTextFeatureTests/ (Swift Testing framework)
• UI Tests: SpeechToTextUITests/ (XCUITest framework)
• Test Plan: SpeechToText.xctestplan coordinates all tests

Configuration

XCConfig Build Settings

Build settings are managed through XCConfig files in Config/:

• Config/Shared.xcconfig - Common settings (bundle ID, versions, deployment target)
• Config/Debug.xcconfig - Debug-specific settings
• Config/Release.xcconfig - Release-specific settings
• Config/Tests.xcconfig - Test-specific settings

App Sandbox & Entitlements

The app is sandboxed by default with basic file access. Edit SpeechToText/SpeechToText.entitlements to add capabilities:

<key>com.apple.security.files.user-selected.read-write</key>
<true/>
<key>com.apple.security.network.client</key>
<true/>
<!-- Add other entitlements as needed -->

macOS-Specific Features

Window Management

Add multiple windows and settings panels:

@main
struct SpeechToTextApp: App {
    var body: some Scene {
        WindowGroup {
            ContentView()
        }

        Settings {
            SettingsView()
        }
    }
}

Asset Management

• App-Level Assets: SpeechToText/Assets.xcassets/ (app icon with multiple sizes, accent color)
• Feature Assets: Add Resources/ folder to SPM package if needed

SPM Package Resources

To include assets in your feature package:

.target(
    name: "SpeechToTextFeature",
    dependencies: [],
    resources: [.process("Resources")]
)

Notes

Generated with XcodeBuildMCP

This project was scaffolded using XcodeBuildMCP, which provides tools for AI-assisted macOS development workflows.