feat: refresh onboarding, setup status, and docs for v1.1.0

Author: psimaker

CHANGELOG.md

@@ -4,6 +4,20 @@ All notable changes to VaultSync are documented here.
 
 ---
 
+## [1.1.0] — 2026-04-22
+
+### Added
+
+- **Localized setup surfaces** — The new onboarding and setup-status copy now ships in English, German, and Simplified Chinese.
+
+### Changed
+
+- **Calmer first launch** — First-run onboarding is now a short, informational 2-screen introduction. Real setup stays on the VaultSync home screen, where pairing, pending shares, vault activity, and sync status already live.
+- **Setup Guide -> Setup Status** — Settings now open a live setup-status and troubleshooting view instead of the old onboarding-style guide. It focuses on essential sync readiness and points users back to the home screen for action.
+- **More honest vault-sync status** — A pending share no longer counts as “done”. Setup Status now keeps vault syncing marked as needing attention until at least one vault is actually active.
+- **Cleaner Settings** — Discovery controls were removed from Settings to reduce noise. Discovery remains enabled by default.
+- **iOS support messaging corrected** — Project docs and release metadata now consistently reflect VaultSync’s iOS/iPadOS 18+ support, while `BGContinuedProcessingTask` remains an iOS 26+ enhancement when available.
+
 ## [1.0.2] — 2026-04-12
 
 ### Fixed

README.md

@@ -21,7 +21,7 @@ Your notes, your devices, your server. No managed note-sync cloud required.
 [![CI](https://img.shields.io/github/actions/workflow/status/psimaker/vaultsync/ci.yml?style=flat-square&logo=github-actions&logoColor=white&label=Build)](https://github.com/psimaker/vaultsync/actions/workflows/ci.yml)
 [![Last Commit](https://img.shields.io/github/last-commit/psimaker/vaultsync?style=flat-square&label=Last+Commit)](https://github.com/psimaker/vaultsync/commits)
 
-[![iOS 26+](https://img.shields.io/badge/iOS-26%2B-007AFF?style=flat-square&logo=apple&logoColor=white)](https://developer.apple.com/ios/)
+[![iOS 18+](https://img.shields.io/badge/iOS-18%2B-007AFF?style=flat-square&logo=apple&logoColor=white)](https://developer.apple.com/ios/)
 [![Swift 6](https://img.shields.io/badge/Swift-6-FA7343?style=flat-square&logo=swift&logoColor=white)](https://swift.org)
 [![Xcode 26+](https://img.shields.io/badge/Xcode-26%2B-147EFB?style=flat-square&logo=xcode&logoColor=white)](https://developer.apple.com/xcode/)
 [![Open Issues](https://img.shields.io/github/issues/psimaker/vaultsync?style=flat-square&label=Issues)](https://github.com/psimaker/vaultsync/issues)
@@ -99,21 +99,19 @@ VaultSync is also not a magic always-on Syncthing daemon for iOS. Apple’s back
 
 ---
 
-## What’s New — v1.0.2
+## What’s New — v1.1.0
 
-> **Reliable Silent-Push Sync** — Background sync now correctly waits for pulls to finish instead of shutting down at the first idle flicker. Fixes the core reason why pushes sometimes arrived but files did not.
+> **Calmer First Launch** — First-run onboarding is now a short 2-screen introduction. Setup itself happens on the VaultSync home screen, where the real device, vault, and sync controls already live.
 >
-> **Server Edits Wake iPhone Again** — `vaultsync-notify` now reacts to real outgoing change markers on the homeserver, so direct edits on your server trigger an iPhone wake-up again without falling back to noisy state-transition pushes.
+> **Setup Status in Settings** — The old setup guide is now a live status and troubleshooting view that highlights what is ready, what still needs attention, and where to fix it.
 >
-> **Recovery When iOS Resumes Cold** — If a silent push wakes VaultSync but Syncthing does not show real peer activity quickly enough, VaultSync now force-restarts the embedded engine and retries within the same background run.
+> **Pending Shares Need Action** — A waiting vault offer no longer looks finished. Vault syncing is only marked ready once at least one vault is actually active.
 >
-> **Longer iOS Grace Period** — The app now holds a background-task assertion on suspend, giving Syncthing more time to wrap up in-flight operations.
+> **Cleaner Settings** — The old discovery controls are gone, reducing noise in Settings while leaving discovery enabled by default.
 >
-> **Correct Vault Path** — Accepting a pending share no longer creates a redundant nested subfolder when the selected Obsidian root already matches the share name.
+> **Localized Setup Flow** — The refreshed onboarding and setup-status copy is now available in English, German, and Simplified Chinese.
 >
-> **Gentler Push Pressure** — `vaultsync-notify` now deduplicates wake-ups per real change marker, reducing the chance of iOS throttling while still covering direct server-side edits.
->
-> **Faster Recovery** — Relay re-provisioning interval reduced from 24h to 6h so a server-side token cleanup heals automatically.
+> **iOS 18+** — VaultSync now supports iOS/iPadOS 18 and later.
 
 See [CHANGELOG.md](CHANGELOG.md) for full details.
 
@@ -133,9 +131,9 @@ VaultSync uses Syncthing to sync your vault between your own devices over LAN or
 
 VaultSync syncs directly into Obsidian’s iOS sandbox. Open Obsidian and your vault is where it should be.
 
-### Guided setup
+### Calm onboarding, real setup
 
-A 5-step checklist helps you pair your iPhone or iPad with an existing Syncthing device via QR code.
+A short first-run onboarding explains the flow, and the actual setup happens on the home screen where you can connect Obsidian, pair devices, accept shares, and monitor sync.
 
 ### Markdown conflict resolver
 
@@ -307,7 +305,7 @@ See [notify/README.md](notify/README.md) for full configuration options.
 
 | Requirement | Details |
 |---|---|
-| iPhone or iPad | iOS/iPadOS 26 or later |
+| iPhone or iPad | iOS/iPadOS 18 or later |
 | Obsidian | Installed on iOS/iPadOS |
 | Syncthing | Running on a Mac, Linux machine, NAS, or homeserver |
 | Cloud Relay | Optional, available via in-app purchase |
@@ -346,10 +344,10 @@ Until then, VaultSync works in two modes:
 
 | | |
 |---|---|
-| Platform | iOS/iPadOS 26+ |
+| Platform | iOS/iPadOS 18+ |
 | Language | Swift 6, SwiftUI |
 | Sync engine | Syncthing v2.x via Go/gomobile `.xcframework` |
-| Background execution | `BGAppRefreshTask` + `BGContinuedProcessingTask` |
+| Background execution | `BGAppRefreshTask` + `BGContinuedProcessingTask` (iOS 26+ when available) |
 | Push wake-ups | APNs silent notifications via Cloud Relay |
 | Notify sidecar | Docker container for homeserver/NAS setups |
 | License | MPL-2.0 |

docs/architecture.md

@@ -39,7 +39,7 @@ Key exports:
 ## Sync Strategy
 
 - **Foreground:** Syncthing runs unrestricted. Immediate, continuous sync.
-- **Background:** `BGAppRefreshTask` (~30s) + `BGContinuedProcessingTask` (iOS 26, longer runtime for user-initiated tasks).
+- **Background:** `BGAppRefreshTask` (~30s) + `BGContinuedProcessingTask` (iOS 26+ when available, longer runtime for user-initiated tasks).
 - **Push sync (Cloud Relay):** Optional. Near-realtime `server -> iPhone` wake-ups via APNs silent push notifications. See [relay-spec.md](relay-spec.md).
 
 ## Directional Behavior

docs/images/screenshot-home.png

@@ -35,7 +35,7 @@ make patch    # creates _syncthing_patched/ with applied fixes
 make xcframework
 ```
 
-This produces `go/build/SyncBridge.xcframework` (~30-50 MB) targeting iOS 26+ (arm64) and iOS Simulator (arm64).
+This produces `go/build/SyncBridge.xcframework` (~30-50 MB) targeting iOS 18+ (arm64) and iOS Simulator (arm64).
 
 ### 5. Generate the Xcode project
 
@@ -50,7 +50,7 @@ xcodegen generate
 open VaultSync.xcodeproj
 ```
 
-Select the **VaultSync** scheme, choose a device or simulator (iOS 26+), and build (Cmd+B).
+Select the **VaultSync** scheme, choose a supported device or simulator (iOS 18+), and build (Cmd+B).
 
 ## Running Tests
 
@@ -71,5 +71,5 @@ cd ios && xcodebuild test \
 - **gomobile not found:** Ensure `$(go env GOPATH)/bin` is in your `$PATH`.
 - **xcframework build fails:** Run `make clean` first, then retry `make xcframework`.
 - **Xcode project missing:** Run `xcodegen generate` in the `ios/` directory.
-- **Simulator not available:** Ensure you have the iOS 26+ simulator runtime installed in Xcode.
+- **Simulator not available:** Ensure you have a supported iOS 18+ simulator runtime installed in Xcode.
 - **Runtime or sync issues after build:** Use [docs/troubleshooting.md](troubleshooting.md).

docs/images/screenshot-welcome.png

@@ -41,10 +41,10 @@ final class SetupChecklistViewModel {
 
     var items: [ChecklistItem] {
         [
-            syncthingItem,
-            desktopDeviceItem,
             obsidianItem,
+            desktopDeviceItem,
             firstShareItem,
+            syncthingItem,
             relayItem
         ]
     }
@@ -78,22 +78,19 @@ final class SetupChecklistViewModel {
         if syncthingManager.isRunning, !syncthingManager.deviceID.isEmpty {
             return ChecklistItem(
                 requirement: .syncthingRunning,
-                title: L10n.tr("Syncthing engine started"),
-                description: L10n.tr("Device ID is available and Syncthing is running."),
+                title: L10n.tr("Sync engine running"),
+                description: L10n.tr("VaultSync’s sync engine is running."),
                 remediation: "",
                 isOptional: false,
                 isComplete: true
             )
         }
 
-        let message = syncthingManager.userError?.message ?? L10n.tr("VaultSync is still starting Syncthing.")
-        let remediation = syncthingManager.userError?.remediation
-            ?? L10n.tr("Keep the app open for a moment. If this persists, restart VaultSync.")
         return ChecklistItem(
             requirement: .syncthingRunning,
-            title: L10n.tr("Syncthing engine started"),
-            description: message,
-            remediation: remediation,
+            title: L10n.tr("Sync engine running"),
+            description: L10n.tr("VaultSync’s sync engine is still starting or unavailable."),
+            remediation: L10n.tr("If this stays unavailable, restart VaultSync and check the home screen for issues."),
             isOptional: false,
             isComplete: false
         )
@@ -104,8 +101,8 @@ final class SetupChecklistViewModel {
         if count > 0 {
             return ChecklistItem(
                 requirement: .desktopDeviceAdded,
-                title: L10n.tr("Desktop device paired"),
-                description: countDescription(count, singular: L10n.tr("device configured"), plural: L10n.tr("devices configured")),
+                title: L10n.tr("Computer or server added"),
+                description: L10n.tr("Your iPhone is paired with at least one Syncthing device."),
                 remediation: "",
                 isOptional: false,
                 isComplete: true
@@ -114,36 +111,31 @@ final class SetupChecklistViewModel {
 
         return ChecklistItem(
             requirement: .desktopDeviceAdded,
-            title: L10n.tr("Desktop device paired"),
-            description: L10n.tr("No desktop or laptop Syncthing device configured yet."),
-            remediation: L10n.tr("Add a device from the main screen using its Syncthing Device ID."),
+            title: L10n.tr("Computer or server added"),
+            description: L10n.tr("Your iPhone is not paired with a Syncthing device yet."),
+            remediation: L10n.tr("Add your computer or server from the Devices section on the home screen."),
             isOptional: false,
             isComplete: false
         )
     }
 
     private var obsidianItem: ChecklistItem {
         if vaultManager.isAccessible {
-            let vaultCount = vaultManager.detectedVaults.count
-            let detail = vaultCount > 0
-                ? L10n.fmt("Connected. %@", countDescription(vaultCount, singular: L10n.tr("vault detected"), plural: L10n.tr("vaults detected")))
-                : L10n.tr("Connected. Waiting for vault folders to appear.")
             return ChecklistItem(
                 requirement: .obsidianConnected,
-                title: L10n.tr("Obsidian connected"),
-                description: detail,
+                title: L10n.tr("Obsidian folder connected"),
+                description: L10n.tr("VaultSync can access your local Obsidian folder."),
                 remediation: "",
                 isOptional: false,
                 isComplete: true
             )
         }
 
-        let issue = vaultManager.accessIssue
         return ChecklistItem(
             requirement: .obsidianConnected,
-            title: L10n.tr("Obsidian connected"),
-            description: issue?.message ?? L10n.tr("VaultSync does not have access to your Obsidian directory."),
-            remediation: issue?.remediation ?? L10n.tr("Connect the Obsidian folder from the main screen."),
+            title: L10n.tr("Obsidian folder connected"),
+            description: L10n.tr("VaultSync cannot access your local Obsidian folder."),
+            remediation: L10n.tr("Connect your Obsidian folder from the VaultSync home screen."),
             isOptional: false,
             isComplete: false
         )
@@ -153,41 +145,41 @@ final class SetupChecklistViewModel {
         if !syncthingManager.folders.isEmpty {
             return ChecklistItem(
                 requirement: .firstShareDetectedOrAccepted,
-                title: L10n.tr("First share detected"),
-                description: countDescription(syncthingManager.folders.count, singular: L10n.tr("shared folder active"), plural: L10n.tr("shared folders active")),
+                title: L10n.tr("Vault syncing"),
+                description: L10n.tr("At least one Obsidian vault is active in VaultSync."),
                 remediation: "",
                 isOptional: false,
                 isComplete: true
             )
         }
 
-        if !syncthingManager.pendingFolders.isEmpty {
+        if !syncthingManager.actionablePendingFolders.isEmpty {
             return ChecklistItem(
                 requirement: .firstShareDetectedOrAccepted,
-                title: L10n.tr("First share detected"),
-                description: countDescription(syncthingManager.pendingFolders.count, singular: L10n.tr("pending share found"), plural: L10n.tr("pending shares found")),
-                remediation: L10n.tr("Open Pending Shares in VaultSync and accept one to start syncing."),
+                title: L10n.tr("Vault syncing"),
+                description: L10n.tr("A vault offer is waiting to be accepted."),
+                remediation: L10n.tr("A vault offer is waiting. Accept it from Pending Shares on the home screen."),
                 isOptional: false,
-                isComplete: true
+                isComplete: false
             )
         }
 
         if syncthingManager.hasSeenPendingFolderOffer {
             return ChecklistItem(
                 requirement: .firstShareDetectedOrAccepted,
-                title: L10n.tr("First share detected"),
-                description: L10n.tr("A share was detected earlier, but there is no active folder yet."),
-                remediation: L10n.tr("If syncing has not started, reshare a vault from desktop Syncthing."),
+                title: L10n.tr("Vault syncing"),
+                description: L10n.tr("A vault offer was seen earlier, but no vault is syncing right now."),
+                remediation: L10n.tr("If syncing has not started, share your Obsidian vault again from Syncthing on your computer."),
                 isOptional: false,
                 isComplete: false
             )
         }
 
         return ChecklistItem(
             requirement: .firstShareDetectedOrAccepted,
-            title: L10n.tr("First share detected"),
-            description: L10n.tr("No folder share from your desktop has been detected yet."),
-            remediation: L10n.tr("From desktop Syncthing, share one vault to this iPhone Device ID."),
+            title: L10n.tr("Vault syncing"),
+            description: L10n.tr("No Obsidian vault is active in VaultSync yet."),
+            remediation: L10n.tr("Share your Obsidian vault from Syncthing on your computer."),
             isOptional: false,
             isComplete: false
         )
@@ -197,8 +189,8 @@ final class SetupChecklistViewModel {
         if subscriptionManager.isRelaySubscribed {
             return ChecklistItem(
                 requirement: .relayConfigured,
-                title: L10n.tr("Cloud Relay configured (optional)"),
-                description: L10n.tr("Instant sync via Cloud Relay is active."),
+                title: L10n.tr("Cloud Relay ready"),
+                description: L10n.tr("Cloud Relay is available for faster background updates."),
                 remediation: "",
                 isOptional: true,
                 isComplete: true
@@ -207,15 +199,11 @@ final class SetupChecklistViewModel {
 
         return ChecklistItem(
             requirement: .relayConfigured,
-            title: L10n.tr("Cloud Relay configured (optional)"),
-            description: L10n.tr("Cloud Relay is off."),
-            remediation: L10n.tr("You can enable it later in Settings for instant push-based sync."),
+            title: L10n.tr("Cloud Relay ready"),
+            description: L10n.tr("Cloud Relay is not enabled."),
+            remediation: L10n.tr("Enable Cloud Relay later in Settings if you want faster background updates."),
             isOptional: true,
             isComplete: false
         )
     }
-
-    private func countDescription(_ count: Int, singular: String, plural: String) -> String {
-        L10n.fmt("%d %@.", count, count == 1 ? singular : plural)
-    }
 }