iOS Reactive List Generator

Generates complete reactive iOS list screens using RxSwift MVVM Input/Output pattern with reactive pagination, pull-to-refresh, and infinite scroll for iOS reactive projects.

When to Activate

• "create reactive list"
• "generate reactive list"
• "new reactive list screen"
• "create rxswift list"
• "generate list with rxswift"
• "new reactive table view"
• "create ios reactive list"
• "generate reactive list with pagination"
• "new list with reactive bindings"

Generation Process

Step 1: Collect Feature Requirements

Use

AskUserQuestion

to collect configuration (present all questions at once):

Required Information:

1. Feature name (CamelCase, e.g., "TransactionHistory")
2. Feature path (e.g., "PayooMerchant/Controllers/Transaction/History")
3. Feature display title (for navigation bar)
4. Pagination type: "date_range", "page_number", or "none"
5. Primary UseCase name (e.g., "TransactionHistoryUseCaseType")
6. Primary UseCase main method (e.g., "getTransactions(fromDate:toDate:)")
7. Domain model item type (e.g., "TransactionItem")
8. Main content cell class (e.g., "TransactionCell")

Optional Information:

• Additional UseCases (comma-separated)
• Custom Input triggers beyond standard (load, loadMore, refresh, selectItem)
• Custom Output drivers beyond standard (items, isLoading, shouldLoadMore, error)
• Header cells (comma-separated class names)
• Additional navigation destinations

Step 2: Read Reference Implementations

Read these files to extract patterns:

# Core reference implementations
PayooMerchant/Controllers/Balance/Information/BalanceInformationViewModel.swift
PayooMerchant/Controllers/Balance/Information/BalanceInformationController.swift
PayooMerchant/Controllers/History/BaseListTransaction/BaseListPaginateDateRangeViewModel.swift

# Form template
/Users/homac34/payoo-ios-app-merchant/PRESENTATION_LAYER_FORM.md

Step 3: Generate Files

Generate these files in the specified

feature_path

:

1. ViewModel (

[Feature]ViewModel.swift

)

From

templates.md

→ Template 1: ViewModel

Key components:

• Import Domain module
• Struct

  [Feature]Filter: FilterPaginationDateRangeProvider

• Class extending

  BaseListPaginationDateRangeViewModel<DomainItem, Filter, Any>

• Input struct with all triggers
• Output struct with all drivers

• transform()

  method
• Override

  fetchItems(_ toDate: Date)

  for pagination

Critical patterns:

• Use

  [weak self]

  in all closures
• All subscriptions use

  .disposed(by: disposeBag)

• API calls use

  .catchSessionError(sessionUC)

  (inherited from base)
• Use

  Driver

  for all outputs (UI-safe)
• Use

  Observable

  for all inputs

2. ViewController (

[Feature]Controller.swift

)

From

templates.md

→ Template 2: ViewController

Key components:

• Extend

  BaseViewController

• IBOutlet for tableView
• PublishSubject triggers matching Input

• viewDidLoad()

  setup

• setupUI()

  - register cells, configure table

• bindViewModel()

  - create Input, transform, bind Output

Critical patterns:

• Pull-to-refresh setup
• Infinite scroll detection (last 3 items)
• Cell registration with

  registerCellByNib

• Error handling with

  showError()

• Navigation via

  navigator.navigate(to:)

3. Navigator Extension (

Navigator+[Feature].swift

)

From

templates.md

→ Template 3: Navigator

Key components:

• Protocol

  [Feature]NavigatorType

• Enum

  [Feature]Destination

  with all navigation cases
• Extension

  Navigator: [Feature]NavigatorType

• Implementation using

  viewControllerFactory

4. Unit Tests (

[Feature]ViewModelTests.swift

)

From

templates.md

→ Template 4: Unit Tests

Key components:

• RxTest with TestScheduler
• Mock UseCases and Navigator
• Test cases for load, loadMore, refresh, selection
• Memory leak test (weak self verification)

Step 4: Generate DI Registration Instructions

Create markdown instructions for manual updates:

File:

DependencyContainer.swift

// Register ViewModel
container.register([Feature]ViewModel.self) { resolver in
    [Feature]ViewModel(
        [feature]UC: resolver.resolve([PrimaryUseCase].self)!,
        navigator: resolver.resolve([Feature]NavigatorType.self)!
    )
}

File:

ViewControllerFactory

extension

extension ViewControllerFactory {
    func make[Feature]Controller() -> [Feature]Controller {
        let controller = [Feature]Controller.instantiate()
        controller.viewModel = DependencyContainer.shared.provide([Feature]ViewModel.self)
        return controller
    }
}

Step 5: Validation Checklist

Before presenting results, verify:

• ✓ All generated files use correct feature name
• ✓ Import statements include

  Domain

  ,

  RxSwift

  ,

  RxCocoa

• ✓ ViewModel extends correct base class for pagination type
• ✓ All closures use

  [weak self]

• ✓ All subscriptions disposed with

  disposeBag

• ✓ Cell classes match existing cells (verify with Glob)
• ✓ Navigator protocol and enum follow naming conventions
• ✓ File paths are absolute and correct

Output Format

Present results as:

✅ iOS Feature Generated: [FeatureName]

📁 Files Created:
  - [feature_path]/[Feature]ViewModel.swift
  - [feature_path]/[Feature]Controller.swift
  - [feature_path]/Navigator+[Feature].swift
  - PayooMerchantTests/ViewModel/[Feature]ViewModelTests.swift

📋 Manual Steps Required:

1. **Register in DependencyContainer.swift**
   [Show code snippet]

2. **Add factory method to ViewControllerFactory**
   [Show code snippet]

3. **Update parent Navigator** (if adding to existing flow)
   [Show navigation destination enum case]

4. **Create XIB file** (optional)
   - File → New → View
   - Name: [Feature]Controller.xib
   - Set File's Owner to [Feature]Controller
   - Connect tableView outlet

🧪 Test the Feature:

1. Build project:
   ```bash
   xcodebuild -workspace PayooMerchant.xcworkspace \
     -scheme "Payoo Merchant Sandbox" \
     -configuration "Debug Sandbox" \
     -sdk iphonesimulator \
     -destination 'platform=iOS Simulator,OS=17.5,name=iPhone 15,arch=x86_64' \
     clean build

2. Run tests:

   xcodebuild test \
     -workspace PayooMerchant.xcworkspace \
     -scheme "PayooMerchantTests" \
     -configuration "Debug Sandbox" \
     -destination 'platform=iOS Simulator,OS=17.5,name=iPhone 15,arch=x86_64' \
     -enableCodeCoverage YES
   

3. Navigate to feature:

   navigator.navigate(to: .[featureName]())

⏱️ Estimated completion time: 15-30 minutes (manual steps)

## Key Patterns Reference

### Date Range Pagination
- Filter conforms to `FilterPaginationDateRangeProvider`
- Domain item conforms to `PaginationDateRangeProvider`
- Uses item's `createdDate` as cursor for next page
- `toDate` becomes last item's date on load more

### RxSwift Memory Safety
- Always `[weak self]` in closures
- Always `.disposed(by: disposeBag)`
- Use `Driver` (never fails, main thread) for UI
- Use `Observable` for inputs

### Navigation Pattern
- Protocol defines interface
- Enum defines destinations with associated values
- Navigator extension implements using factory

---

See `templates.md` for complete code templates.
See `examples.md` for full generated feature example.