Add Slint iOS repository browser

README.md

@@ -9,7 +9,8 @@ application.
 - `gotcha_gitea`: reusable asynchronous Gitea API client with the complete
   typed Gitea 1.25 API and model surface
 - `gotcha`: CLI for typed common operations and arbitrary API requests
-- iOS/Slint app: next crate, bundle identifier `de.rfc1437.gotcha`
+- `gotcha-app`: Slint iOS client for servers, owned repositories, favorites,
+  open issues, and issue details; bundle identifier `de.rfc1437.gotcha`
 
 The generated API modules and models cover every Gitea 1.25 operation. The
 low-level request API remains available for newer instance-specific endpoints;
@@ -57,5 +58,21 @@ accepted as command-line arguments or environment variables.
 1. Exercise and type API areas in the CLI: repositories, issues and pull
    requests, Actions, notifications, organizations, packages, administration.
 2. Add the Slint shell and move proven read workflows into touch-first screens.
-3. Add write workflows and iOS integrations such as secure token storage,
-   sharing, notifications, and background refresh.
+3. Add write workflows and iOS integrations such as sharing, notifications,
+   and background refresh.
+
+## iOS app
+
+Server tokens are kept in the Apple Keychain; the JSON preferences contain only
+server metadata and favorites. The app requires Xcode, XcodeGen, an installed
+iOS Simulator runtime, and Rust's
+`aarch64-apple-ios` and `aarch64-apple-ios-sim` targets. Generate the project
+after installing those prerequisites:
+
+```sh
+cd ios
+xcodegen generate
+open Gotcha.xcodeproj
+```
+
+For a fast host-side check, run `cargo test -p gotcha-app`.