Implement TUI search and mutation workflows

README.md

@@ -80,3 +80,64 @@ The Apple project is generated with XcodeGen:
 cd apple
 xcodegen generate
 ```
+
+## Building
+
+Install a stable Rust toolchain satisfying the workspace manifest (Rust 1.92
+or newer) before building. Commands below run from the repository root unless
+they explicitly change directory. Cargo places debug artifacts in
+`target/debug/` and optimized artifacts in `target/release/`.
+
+Build every Rust crate and application in debug or release mode:
+
+```sh
+cargo build --workspace
+cargo build --workspace --release
+```
+
+Build one frontend at a time:
+
+```sh
+# pass-compatible CLI: target/{debug,release}/ironstorage
+cargo build --package ironstorage-cli
+cargo build --package ironstorage-cli --release
+
+# Ratatui terminal UI: target/{debug,release}/ironstorage-tui
+cargo build --package ironstorage-tui
+cargo build --package ironstorage-tui --release
+
+# Iced desktop UI: target/{debug,release}/ironstorage-desktop
+cargo build --package ironstorage-desktop
+cargo build --package ironstorage-desktop --release
+```
+
+Build only the shared storage library or the Rust Apple bridge:
+
+```sh
+cargo build --package ironstorage --lib
+cargo build --package ironstorage --lib --release
+cargo build --package ironstorage-apple --lib
+cargo build --package ironstorage-apple --lib --release
+```
+
+The iPhone application, AutoFill extension, and watchOS companion require
+macOS, Xcode, XcodeGen, and the Rust Apple targets used by
+`apple/build_rust_core.bash`. Generate the Xcode project after cloning or after
+changing `apple/project.yml`, then build the simulator configuration. The Xcode
+pre-build phase selects the matching Rust debug or release profile.
+
+```sh
+cd apple
+xcodegen generate
+
+# Debug simulator build
+xcodebuild -project IronStorage.xcodeproj -scheme IronStorage \
+  -configuration Debug -sdk iphonesimulator build CODE_SIGNING_ALLOWED=NO
+
+# Release simulator build
+xcodebuild -project IronStorage.xcodeproj -scheme IronStorage \
+  -configuration Release -sdk iphonesimulator build CODE_SIGNING_ALLOWED=NO
+```
+
+For a signed device or archive build, select the desired application target in
+Xcode and configure the development team and signing identities there.