FeedFlow Copilot Assistant

Expert AI assistant for developing FeedFlow, a multi-platform RSS reader built with Kotlin Multiplatform, Compose Multiplatform, and SwiftUI targeting Android, iOS, macOS, Windows, and Linux.

Project Architecture

FeedFlow uses shared business logic via Kotlin Multiplatform with platform-specific UI:

Module Structure

Core Development Workflow

1. Build & Verification

**Build commands for each platform:**

```bash

Full checks (Shared, Android, Desktop)

./gradlew detekt allTests --quiet --console=plain

Static analysis only

./gradlew detekt --quiet --console=plain

iOS code formatting

.scripts/ios-format.sh

Android debug build

./gradlew :androidApp:assembleGooglePlayDebug --quiet --console=plain

Desktop app

./gradlew desktopApp:run --quiet --console=plain

```

**iOS Simulator build:**

```bash

mcp__XcodeBuildMCP__build_sim_name_proj \

projectPath: "/Users/mg/Workspace/feedflow/feed-flow/iosApp/FeedFlow.xcodeproj" \

scheme: "FeedFlow" \

simulatorName: "iPhone 17 Pro"

```

Alternative project paths (use first available):

**CRITICAL: Always build for the specific platform you modified to verify compilation before proceeding.**

2. Testing Strategy

Follow the comprehensive testing guide at `.ai/TESTING.md`.

**Key testing principles:**

**If you add or modify business logic, you MUST add thorough unit tests.**

3. Internationalization

**String resource location:**

```

i18n/src/commonMain/resources/locale/values-[language]/

```

**After adding translations:**

```bash

.scripts/refresh-translations.sh

```

**Rules:**

4. Running the Apps

**Android:**

```bash

.scripts/run-android.sh # Installs and launches on connected device/emulator

```

**Desktop:**

```bash

./gradlew desktopApp:run --quiet --console=plain

```

**iOS:** Build via xcodebuild commands shown above

Platform-Specific Guidelines

iOS Development

Android Development

Shared Code (Kotlin Multiplatform)

Initial Project Setup

If building from scratch:

```bash

Android dummy config

cp config/dummy-google-services.json androidApp/src/debug/google-services.json

cp config/dummy-google-services.json androidApp/src/release/google-services.json

iOS dummy config

cp config/dummy-google-service.plist iosApp/GoogleService-Info-dev.plist

cp config/dummy-google-service.plist iosApp/GoogleService-Info.plist

cp iosApp/Assets/Config.xcconfig.template iosApp/Assets/Config.xcconfig

```

Pre-Handoff Checklist

Before completing work:

1. **If Kotlin/Android/Desktop modified:** Run `./gradlew detekt --quiet --console=plain`

2. **If iOS/Swift modified:** Run `.scripts/ios-format.sh`

3. Fix any issues found in above steps

Git Commit Guidelines

**Example:**

```bash

git commit -m "Add foundation for unified article parsing system"

```

Quick Reference

| Task | Command |

|------|---------|

| Full verification | `./gradlew detekt allTests --quiet --console=plain` |

| Lint only | `./gradlew detekt --quiet --console=plain` |

| Format iOS | `.scripts/ios-format.sh` |

| Run Android | `.scripts/run-android.sh` |

| Run Desktop | `./gradlew desktopApp:run --quiet --console=plain` |

| Refresh translations | `.scripts/refresh-translations.sh` |

| All tests | `./gradlew test --quiet --console=plain` |

Important Notes