Lets Grow: Feedback iOS App

This repository contains the source code for the Lets Grow: Feedback iOS app, available on the App Store.
The app is 100% SwiftUI, The Composable Architecture (TCA) and leverages iOS 26’s Liquid Glass effects.

---

🔧 Requirements

• Swift 6.2
• Xcode 26
• iOS 26
• SwiftLint (brew install swiftlint)

🗂 Project structure

Xcode_project/
  App/                         # App entry, AppDelegate, Composition Root
  Modules/
    Sources/
      RootFeature/             # App root reducer & navigation
      EnterCodeFeature/        # Join flow
      FeedbackFlowFeature/     # Feedback screens and flow
      EventsFeature/           # Event list/detail/create
      MoreFeature/             # Settings/account
      SignUpFeature/           # Sign up
      TabbarFeature/           # Tab coordination
      Domain/                  # Models, errors, service interfaces 
      Adapters/                # Live implementations (API, Firebase, etc.)
      OpenAPI/                 # Spec + generated client (plugin)
      DesignSystem/            # Theme, styles, reusable views
      Logger/, Utility/, InfoPlist/  # Cross‑cutting utilities
    Tests/                     # Reducer & snapshot tests
  Resources/                   # Assets, launch screen, localization
  Docs/                        # Documentation, screenshots, push samples

See also: Xcode_project/Modules/Package.swift for module targets and dependencies.

---

🔌 API Layer

The API layer is fully generated from our OpenAPI specification.
This ensures the client stays in sync with the backend contract.

• Spec and generated client live under Xcode_project/Modules/Sources/OpenAPI/.
• Generation is handled by the Swift OpenAPI Generator plugin during builds; no manual step needed.
• The live APIClient is injected via TCA dependencies.

---

🧪 Testing

• Unit and reducer tests: Xcode_project/Modules/Tests/
• Snapshot tests via swift-snapshot-testing
• Run from Xcode or use the xcodebuild test command above.

---

⚙️ Configuration

Runtime configuration is provided via Info.plist keys and read by a small wrapper in InfoPlist.

Required keys:

Key	Example	Purpose
API_BASE_URL	api.myhost.com	Backend host
API_SCHEME	https	Backend scheme
WEB_BASE_URL	app.myhost.com	Web deep link host
WEB_SCHEME	https	Web scheme
SUPPORT_EMAIL	support@myhost.com	Support link
APPSTORE_ID	1234567890	App Store links

Schemes select different environments (Prod/Debug/Localhost/Mock) using .xcconfig under Xcode_project/App/Config/.

---

🐞 Debugging & Preview

• In DEBUG builds a debug overlay (DebugMenuView) is available.
• Dedicated preview apps exist under Xcode_project/PreviewApps/ for focused UI flows.

---

🔔 Notifications

• Push is enabled via Xcode_project/App/Entitlements.entitlements.
• Sample payloads are in Docs/push_notifications/.
• Local testing on a booted simulator or device:

xcrun simctl push booted <your.bundle.id> Docs/push_notifications/new_feedback_received.apns

Details: Docs/NOTIFICATIONS.md

---

🧰 CI

• Xcode_project/CI_scripts/ci_post_clone.sh relaxes SwiftPM plugin fingerprint checks (needed for the OpenAPI generator) in CI environments.

🏗️ Architecture

The app uses a TCA-based modular architecture built with Swift Package Manager.
Features are self-contained modules that compose together to create the full app experience.

How It Works

TCA Features (RootFeature, EnterCodeFeature, FeedbackFlowFeature, etc.) are the main building blocks:

• Each feature manages its own state, business logic, and UI using TCA patterns
• Features can embed child features and share state via @Shared
• All user interactions and system events flow through TCA actions

Domain Services provide clean interfaces for external interactions:

• APIClient, AuthClient, NotificationClient defined as protocols
• Features call these services via TCA's dependency injection (@Dependency)
• Never directly depend on external SDKs or frameworks

Adapters implement the domain services using real integrations:

• Live implementations use Firebase, OpenAPI-generated clients, system APIs
• Easy to swap for mocks during testing
• All external complexity is contained here

Shared Infrastructure supports all features:

• DesignSystem: UI components, theme colors, typography
• Utility: Extensions and cross-cutting helpers
• Logger: Structured logging with multiple outputs

---
config:
  layout: dagre
---
flowchart TD
    %% TCA Features (main architectural units)
    subgraph Features[TCA Features]
        RootFeature
        TabbarFeature
        EventsFeature
        FeedbackFlowFeature
        EnterCodeFeature
        MoreFeature
        SignUpFeature
    end

    %% Shared Infrastructure
    subgraph Infrastructure[Shared Infrastructure]
        DesignSystem
        Utility
        Logger
    end

    %% Domain Services (interfaces)
    subgraph Domain[Domain Services]
        APIClient["APIClient (interface)"]
        AuthClient["AuthClient (interface)"]
        NotificationClient["NotificationClient (interface)"]
        Models[Models & Types]
    end

    %% Adapters (implementations)
    subgraph Adapters[Adapters]
        APILive["APIClient.live"]
        AuthLive["AuthClient.live"]
        NotificationLive["NotificationClient.live"]
    end

    %% External Systems
    subgraph External[External Systems]
        OpenAPI
        Firebase
        GoogleSignIn
        SystemAPIs["System APIs"]
    end

    %% App Composition
    subgraph App[App Composition]
        AppDelegate["AppDelegate\n(Dependency Injection)"]
    end

    %% Dependencies
    Features --> Infrastructure
    Features --> Domain
    AppDelegate --> Features
    AppDelegate --> Adapters
    Adapters --> Domain
    Adapters --> External
    Infrastructure --> Domain

Loading