mostly android

2026-05-26 09:38:54 -04:00
parent 9ee3d532be
commit 82815009c9
52 changed files with 3397 additions and 214 deletions
--- a/iOS/README.md
+++ b/iOS/README.md
@@ -0,0 +1,156 @@
+# Lendair iOS App
+
+Native iOS SwiftUI application for the Lendair peer-to-peer micro lending platform.
+
+## Setup Instructions
+
+### Prerequisites
+
+- macOS with Xcode 15.0+ installed
+- Homebrew (for package management)
+
+### Installation
+
+1. **Install XcodeGen** (project generator):
+   ```bash
+   brew install xcodegen
+   ```
+
+2. **Generate the Xcode project**:
+   ```bash
+   cd /home/mike/code/lendair/iOS
+   ./generate.sh
+   ```
+
+3. **Open the workspace in Xcode**:
+   ```bash
+   open Lendair.xcworkspace
+   ```
+
+### Project Structure
+
+```
+iOS/
+├── project.yml              # XcodeGen configuration
+├── generate.sh             # Project generation script
+├── README.md              # This file
+└── Lendair/
+    ├── Lendair.xcodeproj  # Generated Xcode project
+    ├── Lendair/
+    │   ├── LendairApp.swift      # App entry point
+    │   ├── ContentView.swift     # Root view with auth routing
+    │   ├── Services/             # Business logic layer
+    │   │   ├── TRPCService.swift    # tRPC client
+    │   │   ├── AuthService.swift    # Authentication
+    │   │   ├── LoanService.swift    # Loan operations
+    │   │   ├── TransactionService.swift
+    │   │   └── AppState.swift       # Global state management
+    │   ├── Models/               # Data models
+    │   │   ├── User.swift
+    │   │   ├── Loan.swift
+    │   │   └── Transaction.swift
+    │   ├── Screens/              # Feature screens
+    │   │   ├── Auth/
+    │   │   │   ├── LoginView.swift
+    │   │   │   └── SignupView.swift
+    │   │   ├── Main/
+    │   │   │   └── MainTabView.swift
+    │   │   ├── Home/
+    │   │   │   └── HomeView.swift
+    │   │   ├── Loans/
+    │   │   │   └── LoansTabView.swift
+    │   │   ├── Activity/
+    │   │   │   └── ActivityTabView.swift
+    │   │   └── Profile/
+    │   │       └── ProfileTabView.swift
+    │   ├── Components/UI/        # Reusable components
+    │   │   ├── PrimaryButton.swift
+    │   │   ├── LendairTextField.swift
+    │   │   ├── BalanceCard.swift
+    │   │   ├── LoanCard.swift
+    │   │   ├── TransactionRow.swift
+    │   │   ├── StatusBadge.swift
+    │   │   ├── LoadingView.swift
+    │   │   ├── ErrorView.swift
+    │   │   └── EmptyStateView.swift
+    │   └── Assets.xcassets/      # App icons, colors, images
+    ├── LendairTests/           # Unit tests
+    └── LendairUITests/         # UI tests
+```
+
+### Architecture
+
+- **Pattern**: MVVM with `@Observable` (Swift 5.9+)
+- **Navigation**: NavigationStack with programmatic navigation
+- **Networking**: tRPC over HTTPS via URLSession
+- **State Management**: Singleton `AppState` with `@Observable`
+
+### Dependencies
+
+Managed via Swift Package Manager:
+
+- **swift-collections** (v1.x): OrderedDictionary and other collection types
+- **swift-algorithms** (v1.x): Pagination helpers and algorithms
+
+### Building
+
+From Xcode or command line:
+
+```bash
+# Debug build
+xcodebuild -workspace Lendair.xcworkspace -scheme Lendair -configuration Debug build
+
+# Release build
+xcodebuild -workspace Lendair.xcworkspace -scheme Lendair -configuration Release build
+```
+
+### Running Tests
+
+```bash
+# Run all tests
+xcodebuild test -workspace Lendair.xcworkspace -scheme Lendair -configuration Debug
+
+# With coverage
+xcodebuild test -workspace Lendair.xcworkspace -scheme Lendair -configuration Debug \
+  -enableCodeCoverage YES
+```
+
+### Environment Configuration
+
+The app supports multiple environments:
+
+| Environment | Base URL |
+|-------------|----------|
+| Development | https://dev.lendair.local |
+| Staging | https://staging.lendair.app |
+| Production | https://api.lendair.app |
+
+Configure via `TRPCEndpoint` enum in `TRPCService.swift`.
+
+### API Endpoints
+
+The iOS app communicates with the SolidStart backend via tRPC:
+
+- **Auth**: `/auth/signin`, `/auth/signup`, `/auth/me`
+- **Loans**: `/loans/available`, `/loans/my`, `/loans/create`, `/loans/accept`
+- **Transactions**: `/transactions/recent`, `/transactions/list`
+
+See [FRE-455](https://git.freno.me/Mike/Lendair/issues/FRE-455) for full API specification.
+
+### Key Features
+
+- ✅ Tab bar navigation (Home, Loans, Activity, Profile)
+- ✅ Authentication screens (Login, Signup)
+- ✅ Home dashboard with balance card
+- ✅ Loan browsing and creation
+- ✅ Transaction history
+- ✅ Profile management
+- ⏳ Create loan form (in progress)
+- ⏳ Accept/repay loan flows (pending)
+- ⏳ Unit tests at NASA standards (pending)
+
+### References
+
+- **Parent Task**: [FRE-457](https://git.freno.me/Mike/Lendair/issues/FRE-457)
+- **Design Spec**: [FRE-452](https://git.freno.me/Mike/Lendair/issues/FRE-452)
+- **Tech Plan**: [FRE-450](https://git.freno.me/Mike/Lendair/issues/FRE-450)