/ 01Two clients, one format
The Fieldbook format is the contract. Both clients read and write the same .fieldbook file, with the same integrity model, the same oplog, the same audit log. You can open a file in one, close it, and open it in the other — sync is implicit because the file is the source of truth.
/ 02Tauri desktop
The default. Tauri 2 wraps a React + TypeScript frontend with a Rust backend that talks directly to fieldbook-core. Available on macOS, Windows, and Linux.
Install
- macOS —
.dmgfrom the download page; drag to Applications - Windows —
.msiinstaller; signed with EV certificate - Linux —
.AppImage(recommended),.deb,.rpm
System requirements
- macOS 12+ · Windows 10 21H2+ · any modern Linux with glibc 2.31+
- 2 GB RAM minimum (4 GB recommended for > 100k row files)
- WebView2 (Windows) — bundled if missing
/ 03macOS native
For teams that want a native macOS experience, the SwiftUI client offers full feature parity plus a few macOS-only views (Lineage, Relationships, native Spotlight integration). It calls into fieldbook-core via UniFFI-generated Swift bindings.
Distribution
- Direct download — notarised
.dmgfrom the download page - TestFlight — request invite from your tenant admin
- MDM — pkg available for Jamf, Kandji, Intune deployment
/ 04First-launch onboarding
Both clients run the same onboarding on first launch:
Identity
Sign in with the configured IdP (Google Workspace, Microsoft Entra, Okta, Auth0). For self-host, point to your own OIDC endpoint.
Encryption preference
Default to "encrypt new files" with a strong password generator. You can switch off per-file at create time.
Sample data
Optional: load "Project Helios" — a demo CDD scenario with 5 entities, 25 requirements, 22 documents.
Engine connection
If a Redline or Atrium engine is configured, the client tests it and surfaces a green/amber indicator. Skippable.
/ 05Client differences
| Capability | Tauri | macOS native |
|---|---|---|
Open / edit .fieldbook | ✓ | ✓ |
| Grid · Kanban · Gallery · Calendar views | ✓ | ✓ |
| Relationship diagram | ✓ | ✓ |
| Lineage view | ✓ | ✓ (faster) |
| Spotlight indexing | — | ✓ |
| Quick Look preview | — | ✓ |
| Touch Bar / menu bar app | — | ✓ |
| Native form-design preview | ✓ | — |
| Browser preview links | ✓ | ✓ |
Feature parity is the goal; deltas are documented per release in CHANGELOG.md.
