Storage

Nitro Storage

Use any Nitro/unstorage driver as the storage backend.

For deployments where you want full control over the storage driver. This mode uses Nitro's built-in useStorage(), which supports dozens of unstorage drivers.

Setup

nuxt.config.ts
export default defineNuxtConfig({
  modules: ['@adamkasper/nuxt-unleash'],

  unleash: {
    url: 'https://your-proxy.example.com/api/frontend',
    token: 'your-frontend-token',
    appName: 'my-app',
    storage: 'nitro',
  },

  nitro: {
    storage: {
      unleash: {
        driver: 'cloudflare-kv-binding',
        binding: 'UNLEASH_CACHE',
      },
    },
    devStorage: {
      unleash: {
        driver: 'memory',
      },
    },
  },
})
Use devStorage to override the driver during local development. The memory driver works without any external services.

Examples

Cloudflare KV (direct binding)

nuxt.config.ts
nitro: {
  storage: {
    unleash: {
      driver: 'cloudflare-kv-binding',
      binding: 'UNLEASH_CACHE',
    },
  },
},

Upstash Redis

nuxt.config.ts
nitro: {
  storage: {
    unleash: {
      driver: 'upstash',
      url: process.env.UPSTASH_REDIS_REST_URL,
      token: process.env.UPSTASH_REDIS_REST_TOKEN,
    },
  },
},

Filesystem (development)

nuxt.config.ts
nitro: {
  storage: {
    unleash: {
      driver: 'fs',
      base: './.data/unleash',
    },
  },
},

When to Use

  • You need a specific storage driver not covered by NuxtHub
  • You deploy to Vercel, Netlify, or a custom platform
  • You want fine-grained control over caching behavior
Copyright © 2026