Offline-First Design

TorrinPass is built with an offline-first architecture, meaning your passwords are always available—even without an internet connection.

What is Offline-First?

Offline-first means:

1. All data is stored locally on your device
2. The app works 100% without internet
3. Cloud sync happens in the background when connected
4. Local data is the source of truth

This is different from apps that cache data for offline use. TorrinPass is designed from the ground up to work offline.

---

How It Works

Local Storage: Core Data

TorrinPass uses Apple’s Core Data framework for local storage:

Your Passwords (encrypted)
        ↓
Core Data (SQLite database)
        ↓
Stored on your device
        ↓
Always available, always fast

Cloud Sync: Firebase Firestore

When you’re online, TorrinPass syncs with Firebase Firestore:

Local Changes → Encrypted → Uploaded to Cloud
Cloud Changes → Downloaded → Decrypted Locally

Conflict Resolution

If you make changes on multiple devices while offline:

1. TorrinPass detects the conflict
2. Most recent change wins (by timestamp)
3. No data is lost—older versions are preserved

---

Benefits of Offline-First

Always Available

• No internet? No problem. Access all your passwords anytime.
• Airplane mode — Works perfectly
• Poor signal areas — No waiting for network
• International travel — No roaming needed

Faster Performance

• Instant access — No network latency
• Immediate search — Local database queries
• Quick copy — No waiting for server response

Better Privacy

• Less network traffic — Fewer opportunities for interception
• Local encryption — Data encrypted before any sync
• Reduced attack surface — Less reliance on cloud services

Reliability

• Server outages don’t affect you — Your passwords are local
• No dependency on internet — Critical for emergencies
• Works everywhere — Basements, planes, remote areas

---

Sync Behavior

When Online

1. Automatic sync — Changes sync in the background
2. Pull-to-refresh — Manually trigger sync
3. Real-time updates — Changes from other devices appear quickly

When Offline

1. Full functionality — Create, edit, delete passwords
2. Changes queued — Modifications saved locally
3. Auto-sync on reconnect — Everything syncs when back online

Sync Indicators

TorrinPass shows clear indicators:

• ✅ Synced — All changes uploaded
• 🔄 Syncing — Upload in progress
• ⚠️ Pending — Changes waiting for connection

---

Technical Details

Core Data Schema

PasswordMO (Managed Object)
├── id: UUID
├── encryptedPayload: Data  // AES-256-GCM encrypted
├── websiteHint: String     // For display (not sensitive)
├── usernameHint: String    // For display (not sensitive)
├── createdAt: Date
├── updatedAt: Date
├── isFavorite: Bool
├── tags: [String]
└── syncStatus: SyncStatus

Firestore Structure

users/{userId}/
├── passwords/{passwordId}
│   ├── encryptedPayload: Blob
│   ├── websiteHint: String
│   ├── usernameHint: String
│   ├── updatedAt: Timestamp
│   └── ...
└── metadata/
    └── lastSyncTimestamp: Timestamp

Bidirectional Sync

1. Upload — Local changes → Firestore
2. Download — Firestore changes → Local
3. Merge — Conflict resolution by timestamp

---

Comparison with Competitors

Feature	TorrinPass	1Password	Dashlane
Offline Access	✅ Full	✅ Full	⚠️ Limited
Local Storage	Core Data	SQLite	Varies
Offline Editing	✅ Yes	✅ Yes	⚠️ Read-only
Sync on Reconnect	✅ Auto	✅ Auto	✅ Auto

---

Use Cases

Travel

• Access passwords on flights
• No roaming charges needed
• Works in remote locations

Emergencies

• Power outages (phone still works)
• Network failures
• Critical password access when needed most

Privacy-Conscious Users

• Minimize cloud interactions
• Reduce network exposure
• Keep data local as much as possible

---

Get Started

Experience true offline-first password management. Download TorrinPass today.

Download on App Store