feat: add macOS app with full feature parity to mobile

.github/workflows/swift-ci.yml

@@ -0,0 +1,135 @@
+name: Swift CI
+
+on:
+  push:
+    branches: ["main", "development"]
+    paths:
+      - "apps/swift/**"
+      - "packages/api/**/openapi.yaml"
+      - ".github/workflows/swift-ci.yml"
+  pull_request:
+    branches: ["**"]
+    paths:
+      - "apps/swift/**"
+      - "packages/api/**/openapi.yaml"
+      - ".github/workflows/swift-ci.yml"
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  # ─── Unit + UI test bundles compile + run on macOS ────────────────────────────
+  build-and-smoke:
+    name: ${{ matrix.scheme }} (smoke)
+    runs-on: macos-15
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - scheme: PackRat-iOS
+            destination: "platform=iOS Simulator,name=iPhone 17,OS=latest"
+            plan: iOS-Smoke
+          - scheme: PackRat-macOS
+            destination: "platform=macOS,arch=arm64"
+            plan: macOS-Smoke
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Select Xcode (use newest available — required by SwiftUI/Observation APIs the app uses)
+        run: |
+          sudo xcode-select -switch /Applications/Xcode.app
+          xcodebuild -version
+          xcrun --show-sdk-version
+
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Install xcodegen
+        run: brew install xcodegen
+
+      - name: Install dependencies
+        env:
+          PACKRAT_NATIVEWIND_UI_GITHUB_TOKEN: ${{ secrets.PACKRAT_NATIVEWIND_UI_GITHUB_TOKEN }}
+        run: bun install --frozen-lockfile
+
+      - name: Generate Xcode project
+        run: bun swift
+
+      - name: Boot iOS simulator
+        if: matrix.scheme == 'PackRat-iOS'
+        run: |
+          # Pick the newest available iPhone runtime and boot a matching device.
+          DEVICE_ID=$(xcrun simctl create CI-Test "iPhone 17" \
+            "$(xcrun simctl list runtimes -j | jq -r '.runtimes[] | select(.identifier | contains("iOS-")) | .identifier' | sort -V | tail -1)")
+          xcrun simctl boot "$DEVICE_ID"
+          xcrun simctl bootstatus "$DEVICE_ID"
+
+      - name: Run ${{ matrix.plan }} test plan
+        env:
+          E2E_EMAIL: ${{ secrets.E2E_EMAIL }}
+          E2E_PASSWORD: ${{ secrets.E2E_PASSWORD }}
+        run: |
+          cd apps/swift
+          # Use signing-bypass on macOS so CI can build/test without a Mac Development cert
+          # provisioned for the runner. iOS Simulator never needs signing.
+          if [ "${{ matrix.scheme }}" = "PackRat-macOS" ]; then
+            CODE_SIGN_ARGS=(CODE_SIGNING_REQUIRED=NO CODE_SIGN_IDENTITY="" CODE_SIGNING_ALLOWED=NO)
+          else
+            CODE_SIGN_ARGS=()
+          fi
+
+          xcodebuild test \
+            -scheme "${{ matrix.scheme }}" \
+            -destination "${{ matrix.destination }}" \
+            -testPlan "${{ matrix.plan }}" \
+            -resultBundlePath "/tmp/${{ matrix.scheme }}-smoke.xcresult" \
+            -quiet \
+            "${CODE_SIGN_ARGS[@]}" \
+            | tee "/tmp/${{ matrix.scheme }}-smoke.log"
+
+      - name: Parse xcresult summary
+        if: always()
+        run: |
+          if [ -d "/tmp/${{ matrix.scheme }}-smoke.xcresult" ]; then
+            xcrun xcresulttool get test-results summary \
+              --path "/tmp/${{ matrix.scheme }}-smoke.xcresult" --compact \
+              | jq '{ result, totalTestCount, passedTests, failedTests, skippedTests, expectedFailures }' || true
+          fi
+
+      - name: Upload xcresult on failure
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: ${{ matrix.scheme }}-smoke-xcresult
+          path: |
+            /tmp/${{ matrix.scheme }}-smoke.xcresult
+            /tmp/${{ matrix.scheme }}-smoke.log
+          if-no-files-found: ignore
+          retention-days: 7
+
+  # ─── Wrapper-script unit tests (vitest) — fast, runs on every PR ──────────────
+  swift-scripts:
+    name: Swift scripts (vitest)
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        env:
+          PACKRAT_NATIVEWIND_UI_GITHUB_TOKEN: ${{ secrets.PACKRAT_NATIVEWIND_UI_GITHUB_TOKEN }}
+        run: bun install --frozen-lockfile
+
+      - name: Run vitest
+        run: bun test:swift:scripts

.gitignore

@@ -51,6 +51,23 @@ apps/guides/public/og/
 .lighthouseci/
 
 # Git worktrees
-.worktrees/
 .worktrees
+.worktrees/
+
+# Xcode (apps/swift)
+apps/swift/xcconfig/*.local.xcconfig
+apps/swift/PackRat.xcodeproj/
+apps/swift/*.xcworkspace/xcuserdata/
+apps/swift/DerivedData/
+apps/swift/.build/
+apps/swift/.swiftpm/
+apps/swift/Package.resolved
+apps/swift/PackRatAPIClient/.build/
+apps/swift/PackRatAPIClient/.swiftpm/
+apps/swift/TestResults/
+
+apps/swift/build/
+
+# Quicktype reference output — generated for inspection, not compiled into the app.
+apps/swift/Generated/
 .turbo/

.zed/settings.json

@@ -0,0 +1,32 @@
+{
+  "languages": {
+    "JavaScript": {
+      "formatter": { "language_server": { "name": "biome" } },
+      "code_actions_on_format": {
+        "source.fixAll.biome": true,
+        "source.organizeImports.biome": true
+      }
+    },
+    "TypeScript": {
+      "formatter": { "language_server": { "name": "biome" } },
+      "code_actions_on_format": {
+        "source.fixAll.biome": true,
+        "source.organizeImports.biome": true
+      }
+    },
+    "TSX": {
+      "formatter": { "language_server": { "name": "biome" } },
+      "code_actions_on_format": {
+        "source.fixAll.biome": true,
+        "source.organizeImports.biome": true
+      }
+    },
+    "JSON": {
+      "formatter": { "language_server": { "name": "biome" } },
+      "code_actions_on_format": {
+        "source.fixAll.biome": true,
+        "source.organizeImports.biome": true
+      }
+    }
+  }
+}

CLAUDE.md

@@ -270,27 +270,24 @@ Defined in root `tsconfig.json`:
 
 ## Database
 
-- ORM: Drizzle (`packages/api/src/db/schema.ts`)
-- Migrations: Drizzle Kit (`drizzle-kit`)
+- ORM: Drizzle (`packages/db/src/schema/` after the schema extraction)
+- Migrations: **always** Drizzle Kit (`drizzle-kit generate`) — never hand-written SQL
 - Embeddings: pgvector with 1536 dimensions
 
-### Migration discipline (read before touching `packages/api/drizzle/`)
+### Migrations — HARD RULE
 
-1. **Always generate via drizzle-kit.** Edit `packages/api/src/db/schema.ts` (or `packages/db/src/schema.ts` for the shared workspace), then run from the API package:
+**Do not hand-write SQL migrations.** Always use Drizzle Kit:
 
-   ```bash
-   cd packages/api && bun run db:generate
-   ```
+1. Change the schema in `packages/api/src/db/schema.ts` or `packages/db/src/schema.ts` / `packages/db/src/schema/*.ts`, depending on where the table is owned.
+2. Run `bun run db:generate` from `packages/api/` or the matching package Drizzle command to emit the migration SQL.
+3. Keep the random migration filename that Drizzle Kit generates. Do not rename it.
+4. Review the generated SQL, snapshot, and journal entry for correctness.
+5. Commit both the schema change and the generated migration in the same PR.
+6. Run `bunx drizzle-kit check` from `packages/api/` before pushing when API migrations changed.
 
-   Drizzle-kit emits a random-name file like `0048_loud_squirrel_girl.sql`. That random name is fine — keep it. The naming convention here is "whatever drizzle-kit gives you."
+Hand-written migrations get out of sync with the schema, drift across environments, and break the Better Auth / drizzle-zod / inferred-TS-types unified pipeline (PR #2414). If `drizzle-kit generate` produces a migration you disagree with, **fix the schema or the generator config** — do not edit the SQL by hand.
 
-2. **Do not rename a generated migration file.** The `meta/_journal.json` `tag` field, the migration SQL filename, and the snapshot filename all encode the migration identity together. Renaming any one of them (even with corresponding journal edits) makes the migration look hand-authored and creates drift that future drizzle-kit operations can mis-handle.
-
-3. **Do not hand-edit `meta/_journal.json`, `meta/*_snapshot.json`, or the generated SQL.** If the generated migration is wrong, fix the schema, delete the bad migration + snapshot + journal entry, and regenerate. Do not patch around it.
-
-4. **Collapse additive changes into one migration when they ship together** — fewer snapshot files in the diff, easier to revert as a unit. Splitting only makes sense when migrations need to land in separate releases.
-
-5. **Verify after generating.** Run `bunx drizzle-kit check` from `packages/api/` — it validates the snapshot chain is internally consistent. Run before pushing.
+If you find a migration in the repo that was hand-written (no `drizzle-kit` provenance), flag it in your PR description and regenerate from schema as a follow-up commit.
 
 ## EAS Build Profiles
 

apps/swift/PackRatAPIClient/Package.swift

@@ -0,0 +1,34 @@
+// swift-tools-version: 5.9
+// This package is used only for `bun swift:codegen` — it is NOT referenced
+// by the Xcode project. The generated Client.swift / Types.swift are
+// committed directly into Sources/PackRat/API/.
+import PackageDescription
+
+let package = Package(
+    name: "PackRatAPIClient",
+    platforms: [
+        .macOS(.v14),
+        .iOS(.v17),
+    ],
+    products: [
+        .library(name: "PackRatAPIClient", targets: ["PackRatAPIClient"]),
+    ],
+    dependencies: [
+        .package(url: "https://github.com/apple/swift-openapi-generator", from: "1.3.0"),
+        .package(url: "https://github.com/apple/swift-openapi-runtime", from: "1.5.0"),
+        .package(url: "https://github.com/apple/swift-openapi-urlsession", from: "1.0.0"),
+    ],
+    targets: [
+        .target(
+            name: "PackRatAPIClient",
+            dependencies: [
+                .product(name: "OpenAPIRuntime", package: "swift-openapi-runtime"),
+                .product(name: "OpenAPIURLSession", package: "swift-openapi-urlsession"),
+            ],
+            path: "Sources/PackRatAPIClient",
+            plugins: [
+                .plugin(name: "OpenAPIGenerator", package: "swift-openapi-generator"),
+            ]
+        ),
+    ]
+)