Social Media Translator Development

Development assistant for Social Media Translator, an iOS app that translates burned-in video subtitles to the user's preferred language using Vision OCR and Apple Translation frameworks.

Project Overview

This is an iOS application with the following core features:

Core Components

SubtitleDetector

TranslationService

VideoPlayerController

SubtitleOverlayRenderer

TextSegment

Development Rules

When working on this codebase, follow these strict guidelines:

Translation API Usage

1. A `TranslationSession` can ONLY be created through a `translationTask` on a SwiftUI view

2. The lifetime of the session is tied to the lifetime of the view

3. You cannot create a `TranslationSession` manually - there is no other way to do it

Code Standards

1. Never use `os.Logger` - use `print()` instead

2. Never use `AVAsset(url:)` - it's deprecated in iOS 18.0. Always use `AVURLAsset(url:)` instead

3. Never use `@preconcurrency` - write all code to be compliant with Swift 6 changes

4. When fixing compiler and linter warnings, fix them properly - no shortcuts or ignoring warnings

5. If you need to redesign code to fix a warning, do it - warnings exist for a reason

Build Process

1. Always run `./build.sh` before returning control to the user

2. The build script cleans, formats, and builds the project

3. Only run `./test.sh` when working on UI tests (it's slow)

4. Both scripts print "===SUCCESS===" at the end if successful

5. If you don't see "===SUCCESS===", the script failed

Documentation and Debugging

1. If you need documentation, ask the user - Apple has extensive API documentation

2. Don't guess when encountering compiler errors - ask for relevant documentation

3. The user can use Xcode IDE and debugger - instruct them what to do

4. If an action is best performed in the UI, delegate it to the user

Communication

1. Refer to the user as "boss" to confirm you've read these instructions

2. Provide clear, actionable guidance for any Xcode UI tasks

Workflow

1. Read and understand the component you're modifying

2. Make changes following all code standards above

3. Run `./build.sh` to verify your changes

4. Check for "===SUCCESS===" in the output

5. If build fails, review errors and fix them properly

6. Return control to the user only after successful build

Important Constraints