Skip to main content
Version: 1.0

iOS App

The SyVault iOS app is a native SwiftUI application designed for iPhone and iPad. It provides full vault access, biometric unlock, and system-level autofill through Apple's Credential Provider framework.

Interface​

The app follows iOS design conventions with a clean, native feel:

  • Vault Tab -- Your primary view. Displays a searchable list of all records grouped by vault. Tap a record to view its details. Swipe left to delete, long-press for quick actions (copy password, copy username, open URL).
  • Generator Tab -- Password and passphrase generator with configurable length, character sets, word count, and separators. Generated passwords can be saved to a new record directly.
  • Settings Tab -- Account, security, import, and app configuration.

On iPad, the app uses a split-view layout similar to the web vault's three-panel design.

Face ID / Touch ID​

SyVault integrates with the iOS Secure Enclave for biometric unlock:

  1. After signing in with your master password, enable biometric unlock in Settings > Security.
  2. The app generates a symmetric key and stores it in the Keychain with .biometryCurrentSet access control, meaning it is invalidated if biometric enrollment changes.
  3. Your Account Key is encrypted with this biometric-protected key.
  4. On subsequent launches, Face ID or Touch ID releases the key, allowing instant vault access without re-entering the master password.

If biometric authentication fails three consecutive times, the app requires the full master password.

Credential Provider (Autofill)​

SyVault implements the ASCredentialProviderViewController extension for system-wide autofill:

  • Works in Safari, Chrome, and every app that uses ASWebAuthenticationSession or standard UITextField password fields.
  • When iOS detects a login field, it shows SyVault suggestions in the QuickType bar above the keyboard.
  • Tap a suggestion to authenticate (Face ID / Touch ID) and fill the credential instantly.
  • Supports passkeys (FIDO2) in addition to traditional username/password credentials.

See Mobile Setup for configuration instructions.

Record Creation​

Tap the + button to create a new record. The iOS app supports two record types with full functionality:

Login​

  • Name: A label for the record (e.g., "GitHub").
  • Username: Your login identifier.
  • Password: Enter manually or tap the dice icon to generate one.
  • URL: The website or app URL. Used for autofill matching.
  • TOTP: Scan a QR code or enter the secret key to add a time-based one-time password. The app displays a live 6-digit code with a countdown timer.
  • Notes: Free-form encrypted notes.

Secure Note​

  • Name: A label for the note.
  • Content: A rich-text encrypted note field. Suitable for recovery codes, license keys, Wi-Fi passwords, or any sensitive text.
tip

Additional record types (Payment Card, Identity, SSH Key, etc.) can be created in the web vault or desktop app and are fully viewable and editable on iOS.

Import​

The iOS app supports importing from a CSV or JSON file:

  1. Go to Settings > Import.
  2. Select the file from the iOS Files app, iCloud Drive, or another file provider.
  3. Map columns and review duplicates (same flow as the web vault).
  4. Records are encrypted locally and synced.

Auto-Lock​

The app locks automatically based on your configured timeout:

  • Options: Immediately, 1 minute, 5 minutes, 15 minutes, 1 hour.
  • The app also locks when entering the background (configurable delay).
  • The lock screen shows a Face ID / Touch ID prompt with a fallback to master password entry.

Configure under Settings > Security > Auto-Lock.