FeedFlow RSS Reader Development

Expert development assistant for FeedFlow, a multi-platform RSS reader built with Kotlin Multiplatform, Compose Multiplatform, and SwiftUI.

Project Overview

FeedFlow is a minimalistic RSS Reader available on Android, iOS, macOS, Windows, and Linux. The architecture leverages:

Module Structure

Development Instructions

1. Build and Verification Commands

**Run all checks (Shared, Android, Desktop):**

```bash

./gradlew detekt allTests

```

**Static analysis:**

```bash

./gradlew detekt

```

**Format iOS code:**

```bash

.scripts/ios-format.sh

```

**Run all tests:**

```bash

./gradlew test

```

**Regenerate translations after adding new strings:**

```bash

.scripts/refresh-translations.sh

```

**Build Android debug:**

```bash

./gradlew :androidApp:assembleGooglePlayDebug

```

**Run Android app:**

```bash

.scripts/run-android.sh

```

**Run Desktop app:**

```bash

./gradlew desktopApp:run

```

**ALWAYS run gradle tasks with:**

```bash

--quiet --console=plain

```

2. iOS Development

**Building for iOS simulator (iPhone 17 Pro):**

Check project paths in this order:

1. `/Users/mg/Workspace/feedflow/feed-flow/iosApp/FeedFlow.xcodeproj`

2. `/Users/mg/Workspace/feedflow/feed-flow-2/iosApp/FeedFlow.xcodeproj`

3. `/Users/marco.gomiero/Workspace/tmp/feed-flow/iosApp/FeedFlow.xcodeproj`

Use xcodebuild with `-quiet` flag. Only remove `-quiet` if errors occur and you need detailed output.

**iOS SDK Support:**

**iOS Code Style:**

3. Testing Requirements

All tests MUST follow guidelines in `.ai/TESTING.md`:

**CRITICAL:** If you touch or create business logic, write thorough unit tests.

4. Build Verification Process

**MANDATORY after editing code:**

1. Build the project for the platform you modified

2. Fix all compilation errors before proceeding

3. Only build for the platform you're working on to save time

5. Internationalization

**String resources location:**

```

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

```

**After adding new translations:**

```bash

.scripts/refresh-translations.sh

```

**RULES:**

6. Code Style and Conventions

**Comments:**

**Error Handling:**

**Git Commit Messages:**

7. Handoff Checklist

Before handing off, complete these steps:

1. Run `./gradlew detekt` to ensure all checks pass (skip if only Swift files modified)

2. Run `.scripts/ios-format.sh` to format iOS code (only if iOS changes made)

3. Fix any issues found during the above steps

8. Initial Setup (Building from Scratch)

**Android configuration:**

```bash

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 configuration:**

```bash

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

```

Workflow Summary

1. Read the task requirements

2. Identify which platform(s) are affected

3. Make code changes following style conventions

4. Write unit tests if business logic is affected

5. Build for the affected platform(s)

6. Fix any compilation errors

7. Run platform-specific linting/formatting

8. Verify all checks pass before handoff

Important Constraints