🔥 MongoFire — Offline‑First Sync for MongoDB (Local + Atlas)

Offline-first MongoDB sync — Local + Atlas feel like ONE database. Automatic conflict resolution, Mongoose plugin, interactive CLI, zero boilerplate.

MongoFire keeps a local MongoDB and MongoDB Atlas in sync — automatically, reliably, and with zero boilerplate. Your app reads and writes to a local MongoDB instance that is always fast and always available, even when offline. MongoFire handles everything else in the background.

• ⚡ Offline-first — your app never waits for network
• 🔁 Automatic sync — local and remote changes reconciled
• 🛡 Field-level conflict resolution — prevents data loss
• 🔄 Schema migrations — automatic version upgrades
• 🏎 Diff/Patch — sync only changed fields to save bandwidth
• ⚙ Production-ready — rate limiting, circuit breaker, auto-compaction
• 🧰 CLI & TypeScript — easy management and full type support

📦 Configuration Options

• (configurable in mongofire.config.js)
• localUri — Local MongoDB connection string
• atlasUri — MongoDB Atlas URI
• dbName — Database name
• collections — Which collections to sync
• syncInterval — ms between automatic sync cycles
• batchSize — Documents per batch during sync
• syncOwner — Owner filter for multi‑tenant or per‑user sync
• realtime — Enable change streams
• onSync / onError — Hooks for logging and custom handling

🔄 Automatic Sync & Control API

• Programmatically manage sync:
• mongofire.start(config) → Start syncing (initial + background)
• mongofire.stop(timeout?) → Stop sync gracefully
• mongofire.sync(type?) → Manual sync trigger
• mongofire.status() → Get sync and queue status
• mongofire.clean(days?, opts) → Clean old synced records
• mongofire.conflicts() → List sync conflicts
• mongofire.retryConflict(opId) → Retry a conflict operation
• mongofire.dismissConflict(opId) → Dismiss and let remote win
• mongofire.reconcile(...) → Recover writes lost in a crash
• mongofire.resetLocal() → Safely wipe local DB + state

CLI Tools & Commands

• Interactive terminal commands that MongoFire provides:
• npx mongofire init — Setup wizard
• mongofire config — Update config
• mongofire status — Show pending ops/state
• mongofire clean, conflicts, reconcile, reset-local — Tools for maintenance and recovery

Advanced Features

• Full TypeScript Interfaces — TS types available for SyncConfig, SyncResult, ConflictData, etc.
• Safe Local Reset/Re‑bootstrap — Wipes local DB but resumes cleanly on next start.
• Manual Conflict Tools — You can manually inspect conflicts, retry, or dismiss.
• Real‑time Sync Fallback — If change streams aren’t available, it will fall back to polling.

Mongofire on Npm