TaskFlow

TaskFlow is a Chinese-first SwiftUI task manager for iPhone and Mac.

Version 1 Scope

• Today-first task list
• Today, tomorrow, week, and month task scopes
• Task title, details, priority, completion, and optional reminder
• Priority colors inspired by game item rarity
• Recurring task templates that generate independent task instances
• Plain-text notes
• Simple local reminders
• iCloud-backed SwiftData configuration
• Mac sidebar navigation and keyboard shortcuts
• iPhone navigation with a compact sidebar flow and top-right add action
• Chinese UI with English localization resources
• Disabled AI provider boundary for a future downloadable local writing assistant

AI Assistant Path

Version 1 does not ship a built-in AI model. The app includes an AIProvider boundary and Settings UI state so a future release can offer an optional local model download for note polishing and continuation.

The planned AI direction is local and optional:

• Keep core tasks and notes fully usable when AI is not downloaded.
• Avoid bundling a large model inside the initial App Store binary.
• Add a later Settings download flow for a compact text-assistance model.
• Clearly disclose any future provider that sends content off-device.

Development

Requirements:

• Full Xcode installation
• XcodeGen

Generate the Xcode project:

xcodegen generate

Run unit tests in the current Mac Catalyst environment:

xcodebuild test -scheme TaskFlow -destination 'platform=macOS,variant=Mac Catalyst,name=My Mac' CODE_SIGNING_ALLOWED=NO -skip-testing:TaskFlowUITests

Run the iPhone simulator test suite when an iOS runtime is installed:

xcodebuild test -scheme TaskFlow -destination 'platform=iOS Simulator,name=iPhone 16'

Build Mac Catalyst:

xcodebuild -scheme TaskFlow -destination 'platform=macOS,variant=Mac Catalyst' build

Manual Verification

Before App Store submission, verify:

1. iPhone opens to Today.
2. The add button creates a task with title, details, priority, and optional reminder.
3. The left completion circle toggles task completion.
4. Swiping left deletes a task on iPhone.
5. Mac Catalyst shows the sidebar and supports right-click delete.
6. Command-1 through Command-4 select task scopes on Mac.
7. Notes can be created, edited, and deleted.
8. Settings shows language, iCloud status, recurring task management, and AI unavailable.
9. A daily recurring template generates only one task for the current day.

App Store Notes

• Confirm bundle identifier, signing, app icon, privacy labels, and notification permission copy before release.
• Keep local notification and iCloud behavior covered in the App Store privacy answers.
• Treat the downloadable AI assistant as a later release unless model size, licensing, and disclosure are finalized.