Documentation
Back to Dashboard

Offline Features

Work on your content workflow without internet connectivity. Capture, review, and generate content offline with automatic sync.

Planes. Subways. Bad conference WiFi. Your content workflow shouldn't stop when your internet does. BlackOps Center's offline-first architecture keeps you productive anywhere.

How Offline Mode Works

BlackOps Center uses a local-first approach. Data is stored on your device first, then synced to the cloud when connectivity returns. This means:

  • No loading spinners when offline
  • No "connection error" messages blocking your work
  • Automatic sync when you reconnect
  • Conflict resolution if you edited the same content on multiple devices

Offline-First vs. Offline-Capable

Offline-Capable (Most Apps):

You can view cached data, but actions are blocked until you're online. Frustrating.

Offline-First (BlackOps Center):

You can capture, edit, generate, and review content. Everything queues locally and syncs later. Seamless.

What Works Offline

Full Functionality

These features work identically online or offline:

  • Content Capture: Save URLs, ideas, notes via iOS Shortcuts or mobile web
  • Reservoir Browsing: View previously synced reservoir items
  • Tagging & Categorization: Tag, star, archive items
  • Reading: Read full content of cached items
  • Search: Search within cached content
  • Notes: Add notes to reservoir items
  • Draft Editing: Edit blog drafts stored locally

Degraded Functionality

These features work offline but with limitations:

AI Content Generation

  • Offline: Requests are queued locally
  • When Online: AI processes queued requests
  • Notification: You're notified when generation completes

RSS Feed Updates

  • Offline: Feeds don't refresh (obviously)
  • Cached Items: Previously fetched items remain readable
  • When Online: Automatic catch-up fetch

Analytics Dashboard

  • Offline: Shows last-synced data with timestamp
  • Warning: "Offline - Data as of [timestamp]"
  • When Online: Live data resumes

Unavailable Offline

These features require real-time connectivity:

  • Publishing Content: Actual publication to your blog (queued for later)
  • Social Media Posting: Live posting to Twitter, LinkedIn (queued)
  • Newsletter Sending: Email delivery (queued)
  • Stripe Payments: Billing operations
  • Team Collaboration: Real-time updates from team members

Offline Workflow Examples

Scenario 1: The Cross-Country Flight

Duration: 6-hour flight, no WiFi

Before Takeoff:

  1. Open BlackOps Center on your phone/iPad
  2. Navigate to your main reservoirs (triggers cache refresh)
  3. Open any drafts you want to edit
  4. Optional: Manually trigger "Download for Offline"

During Flight (Offline):

  1. Hour 1: Browse and read 20 cached RSS articles
    • Star 5 interesting ones
    • Add notes to 3 of them
    • Tag all with relevant categories
  2. Hour 2-3: Generate 3 blog outlines
    • Tap "Generate Outline" on starred items
    • Requests queue locally
    • Review and edit existing drafts
  3. Hour 4-5: Write blog post #1
    • Use cached reservoir content as research
    • Copy/paste quotes from saved articles
    • Draft saved locally
  4. Hour 6: Plan next week's content
    • Review content calendar (cached)
    • Assign topics to days
    • Queue social posts for each article

After Landing (Back Online):

  1. Connect to airport WiFi
  2. BlackOps Center auto-syncs:
    • 20 read items marked as read
    • 5 starred items synced
    • 3 outline generation requests processed by AI
    • 1 blog draft uploaded
    • Social posts queued for publishing
  3. Notification: "Offline work synced. 3 outlines ready to review."

Result: 6 hours of offline productivity = 1 published blog post, 3 outlines, 20+ articles processed

Scenario 2: The Subway Commute

Duration: 45 minutes, spotty service

Morning Commute (7:30 AM):

  1. Train pulls into station → grab fresh RSS items (online for 30 seconds)
  2. Train enters tunnel → offline reading mode kicks in
  3. Read 10 articles, star 3, tag all
  4. Train exits tunnel → auto-sync
  5. Repeat 3-4 times during commute

Result: Seamless reading experience despite intermittent connectivity

Scenario 3: The Weekend Cabin

Duration: 48 hours, no internet

Friday Evening (Before Leaving):

  1. Open BlackOps Center
  2. Tap "Download for Offline" in settings
  3. Downloads:
    • All reservoir items from last 30 days
    • All drafts
    • Content calendar
    • Analytics snapshot
  4. Storage used: ~50MB

Weekend Activities (Offline):

  • Saturday morning: Deep dive into research articles
  • Saturday afternoon: Write 2 blog posts
  • Sunday morning: Generate outlines for next week
  • Sunday afternoon: Plan editorial calendar

Monday Morning (Back Online):

  1. Open BlackOps Center
  2. Auto-sync runs
  3. 2 blog drafts uploaded
  4. 5 outline generation requests processed
  5. Editorial calendar updated

Result: Productive weekend without compromising your digital detox goals

Technical Implementation

Service Workers

BlackOps Center uses modern Service Worker APIs to cache assets and data:

// Service Worker caching strategy
const CACHE_NAME = 'blackops-v1'
const OFFLINE_URLS = [
  '/',
  '/reservoirs',
  '/drafts',
  '/analytics',
  '/manifest.json'
]

// Cache-first strategy for reservoir content
self.addEventListener('fetch', (event) => {
  if (event.request.url.includes('/api/reservoirs')) {
    event.respondWith(
      caches.match(event.request)
        .then(response => response || fetch(event.request))
    )
  }
})

IndexedDB for Local Storage

Structured data (reservoir items, drafts, tags) is stored in IndexedDB for fast, reliable offline access:

// Example IndexedDB schema
{
  reservoirs: [
    {
      id: 'abc123',
      name: 'React Performance',
      items: [...],
      lastSync: '2025-02-01T10:00:00Z'
    }
  ],
  pendingActions: [
    {
      type: 'STAR_ITEM',
      itemId: 'xyz789',
      timestamp: '2025-02-01T11:30:00Z'
    },
    {
      type: 'GENERATE_OUTLINE',
      topic: 'React Server Components',
      reservoirId: 'abc123',
      timestamp: '2025-02-01T12:00:00Z'
    }
  ]
}

Background Sync API

When you regain connectivity, the Background Sync API ensures all pending actions are uploaded, even if you've closed the app:

// Register background sync
navigator.serviceWorker.ready.then(registration => {
  return registration.sync.register('sync-pending-actions')
})

// Service Worker handles sync
self.addEventListener('sync', event => {
  if (event.tag === 'sync-pending-actions') {
    event.waitUntil(syncPendingActions())
  }
})

Conflict Resolution

What if you edit the same draft on two devices while offline? BlackOps Center uses last-write-wins with conflict detection:

  1. Both devices sync when online
  2. Server detects conflicting timestamps
  3. You're prompted: "Draft was edited on [Device A]. Keep [Device A] version or [Device B] version?"
  4. Losing version is saved as a conflict backup

Offline Configuration

Auto-Download Settings

Control what gets cached automatically:

  1. Go to Settings → Offline Mode
  2. Configure:
    • Reservoir History: Last 7, 14, or 30 days
    • RSS Items: High-score only (8+) or all
    • Drafts: All drafts or only active ones
    • Analytics: Last 7 or 30 days
    • Images: Cache images (uses more storage)
  3. Estimated storage: Display current cache size
  4. Clear cache: Option to purge old data

Storage Limits

Most browsers allow 50-100MB of offline storage before prompting. Be strategic about what you cache. Text-only mode uses ~10MB. Adding images can balloon to 200MB+.

Manual Download

Prepare for extended offline sessions:

  1. Tap "Download for Offline" in settings
  2. Select specific reservoirs to download
  3. Choose date range
  4. Toggle "Include Images"
  5. Tap "Download Now"
  6. Progress indicator shows download status

Offline Indicator

A subtle indicator in the app header shows your connectivity status:

  • Green dot: Online, actively syncing
  • Yellow dot: Offline, using cached data
  • Red dot: Offline, cache may be stale (>7 days old)

Best Practices

Pre-Flight Checklist

Before going offline (plane, cabin, international travel):

  1. Sync all devices while online
  2. Manually download content you'll need
  3. Review pending actions (make sure nothing critical is stuck)
  4. Check storage space on device
  5. Optional: Export critical drafts as backup

Offline Work Habits

  • Batch Reads: Read all content in one session (faster than switching)
  • Queue Generations: Trigger multiple AI requests at once
  • Draft Locally First: Write in offline-friendly plain text, format later
  • Trust the Sync: Don't stress about connectivity, it'll sync when it can

Return to Online

When connectivity returns:

  1. Wait for "Syncing..." notification to complete
  2. Review sync conflicts (if any)
  3. Check for new content (RSS, team updates)
  4. Verify critical actions (publications, social posts)

Offline-First Keyboard Shortcuts

Optimize offline navigation with keyboard shortcuts:

  • Cmd/Ctrl + K - Search cached content
  • Cmd/Ctrl + D - Download current view for offline
  • Cmd/Ctrl + Shift + S - Force sync pending actions
  • Cmd/Ctrl + I - Toggle offline mode (for testing)

Progressive Web App (PWA)

Install as App

On mobile (iOS/Android):

  1. Visit blackopscenter.com in Safari/Chrome
  2. Tap share button
  3. Select "Add to Home Screen"
  4. App icon appears on your home screen
  5. Launches in full-screen mode (no browser chrome)
  6. Works offline automatically

On desktop (Chrome/Edge):

  1. Visit blackopscenter.com
  2. Click install icon in address bar
  3. BlackOps Center installs as desktop app
  4. Launches in dedicated window
  5. Offline support enabled

PWA Benefits

  • No App Store: Install directly from web
  • Auto-Updates: Always latest version
  • Platform-Native Feel: Looks and feels like a real app
  • Offline-First by Default: Service workers handle everything

Troubleshooting

Content Not Loading Offline

Cause: Content wasn't cached before going offline

Fix:

  1. When online, navigate to the content you need
  2. Wait for "Cached" indicator in corner
  3. Or use "Download for Offline" feature

Sync Stuck

Cause: Large amount of pending actions, slow connection

Fix:

  1. Check Settings → Offline → Pending Actions
  2. View sync queue
  3. Optionally cancel low-priority actions
  4. Wait for better connectivity
  5. Force retry: Tap "Sync Now"

Storage Full

Cause: Browser storage limit reached

Fix:

  1. Go to Settings → Offline → Storage
  2. See breakdown of cache size
  3. Clear old data: "Clear Cache Older Than 30 Days"
  4. Disable image caching if needed
  5. Reduce history range (7 days instead of 30)

Duplicate Actions After Sync

Cause: Sync ran twice (edge case)

Fix:

  1. Auto-resolved by server (duplicate detection)
  2. If you notice duplicates, report via Support
  3. Future releases will improve deduplication

Offline Analytics

Even offline, BlackOps Center tracks your productivity:

  • Items Read: Count of articles reviewed
  • Captures: Number of items saved
  • Generations Queued: AI requests triggered
  • Time Spent: Active app time
  • Offline Sessions: Duration and productivity of offline work

View your "Offline Productivity Report" in Analytics → Offline Stats.

Future Offline Features

Coming soon:

  • Offline AI: Small language model runs on-device for basic generations
  • Peer-to-Peer Sync: Sync between your devices without server
  • Offline-First Collaboration: Leave comments/reviews that sync later
  • Smart Pre-Fetch: ML predicts what you'll need, downloads proactively
  • Offline Search: Full-text search of cached content

Offline Power User Tip

Schedule "offline days" deliberately. Disable WiFi for 4-6 hours. Force yourself to work with only cached content. You'll be amazed how much you accomplish without the distraction of the live internet.

Next Steps

The internet is unreliable. Your workflow shouldn't be.

Want this page as machine-readable markdown? GET /docs/mobile/offline.md