cache-cleaner

A small utility to clear development and browser caches to help speed up iteration and avoid stale assets during local development.

Features

• Node API: detect and remove common cache/build folders like .next, .vite, dist, build, and node_modules/.cache.
• Browser API: clear localStorage, sessionStorage, delete IndexedDB (when available), unregister service workers, and optionally hard reload the page.
• CLI: npx cache-cleaner with options for dry-run and custom folders.

Usage

Node:

import { clearCache } from 'cache-cleaner';

await clearCache(['dist', 'node_modules/.cache']);

Browser:

import { clearBrowserCache } from 'cache-cleaner';

clearBrowserCache({
  clearLocalStorage: true,
  clearSessionStorage: true,
  clearIndexedDB: true,
  unregisterServiceWorkers: true,
  hardReload: true
});

CLI:

npx cache-cleaner

Testing

Run unit tests with:

npm install
npm test