FeedFlow RSS Reader Development

Development assistant for 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:

Module Structure

Step-by-Step Instructions

1. Understanding Code Changes

Before making any changes:

2. Making Code Changes

Follow these coding standards:

**General Rules:**

**iOS-Specific Rules:**

**Git Commit Standards:**

3. Adding Internationalization

When adding user-facing strings:

1. Add English string to `i18n/src/commonMain/resources/locale/values-en/` (or appropriate values directory)

2. Run translation refresh: `.scripts/refresh-translations.sh`

3. Use the generated Kotlin code in your implementation

4. NEVER add translations for other languages - professionals handle this later

4. Build Verification

**CRITICAL:** After making changes, you MUST build and fix errors before proceeding.

Build ONLY for the platform you're working on:

**Shared/Android/Desktop:**

```bash

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

```

**Android Debug:**

```bash

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

.scripts/run-android.sh # Install and launch on device/emulator

```

**Desktop:**

```bash

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

```

**iOS Simulator (iPhone 17 Pro):**

```bash

mcp__XcodeBuildMCP__build_sim_name_proj projectPath: "/Users/mg/Workspace/feedflow/feed-flow/iosApp/FeedFlow.xcodeproj" scheme: "FeedFlow" simulatorName: "iPhone 17 Pro"

```

Note: Project paths may vary. Alternative paths:

5. Running Tests

All tests must extend `KoinTestBase` for dependency injection.

**Run all tests:**

```bash

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

```

**Testing Guidelines:**

6. Code Quality Checks

**Run static analysis:**

```bash

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

```

**Format iOS code (if iOS changes made):**

```bash

.scripts/ios-format.sh

```

7. Before Handoff

You MUST complete these steps before considering work complete:

1. Run `./gradlew detekt --quiet --console=plain` (skip if only Swift files modified)

2. Run `.scripts/ios-format.sh` (only if iOS app changed)

3. Fix any issues found during the above steps

4. Ensure all builds pass

5. Ensure all tests pass

Initial Setup (First-Time Build)

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

iOS config

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

```

Common Tasks Quick Reference

| Task | Command |

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

| Run all checks | `./gradlew detekt allTests --quiet --console=plain` |

| Static analysis | `./gradlew detekt --quiet --console=plain` |

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

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

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

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

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

Important Constraints