Examples

Practical examples for common use cases.

Use Case Overview

Use CaseKey Features
Static SitesLong TTL, stale-if-error fallback
E-commerceProduct caching, cart exclusion
News/MediaShort TTL, background refresh
SPAAPI caching, offline support
CMSManifest invalidation, SSE

Configuration Templates

Minimal Setup

importScripts('https://unpkg.com/@maravilla-labs/zephyr@0.2.0/lib/zephyrWorker.js');

const config = {
  rules: [
    { test: '.*\\.(png|jpg|css|js)$', cache: 60 }
  ]
};

initZephyr(config);

Production Setup

importScripts('https://unpkg.com/@maravilla-labs/zephyr@0.2.0/lib/zephyrWorker.js');

const config = {
  rules: [
    // Static assets
    {
      test: '.*\\.(png|jpg|jpeg|gif|webp|svg|ico)$',
      cache: 1440,
      maxEntries: 200,
      fallback: { strategy: 'stale-if-error', maxStaleAge: 2880 }
    },
    // CSS/JS
    {
      test: '.*\\.(css|js)$',
      cache: 1440,
      maxEntries: 50
    },
    // API
    {
      test: '.*\\/api\\/.*',
      method: 'GET',
      cache: 5,
      maxEntries: 100,
      fallback: { strategy: 'stale-while-revalidate' }
    }
  ],
  quota: {
    maxSize: 50 * 1024 * 1024,
    warningThreshold: 0.8,
    onQuotaExceeded: 'evict-lru'
  }
};

initZephyr(config);