https://github.com/serhalp/netlify-cache-inspector
Netlify cache inspector: inspect & compare cache headers for requests to Netlify sites
https://github.com/serhalp/netlify-cache-inspector
http-cache netlify
Last synced: 25 days ago
JSON representation
Netlify cache inspector: inspect & compare cache headers for requests to Netlify sites
- Host: GitHub
- URL: https://github.com/serhalp/netlify-cache-inspector
- Owner: serhalp
- Created: 2024-09-13T14:45:50.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2026-06-14T16:48:52.000Z (about 1 month ago)
- Last Synced: 2026-06-14T17:17:34.372Z (about 1 month ago)
- Topics: http-cache, netlify
- Language: TypeScript
- Homepage: https://cache-inspector.netlify.app
- Size: 4.47 MB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# Netlify Cache Inspector
A web app for inspecting and comparing caching behaviour on live Netlify sites.
Submit a URL and the app fetches it with Netlify's debug headers enabled, then displays a structured breakdown of the caching behavior: which cache layers were hit, cache-control directives, TTLs, and more. Run the same URL multiple times and compare results side-by-side with interactive hover-based diffing.
## Getting started
Requires Node.js >= 20 and pnpm (enable via `corepack enable`).
```sh
pnpm install
pnpm run dev
```
The dev server starts at http://localhost:3000 if port is 3000 is available.
## How it works
1. You enter a Netlify-hosted URL
2. The server fetches it and extracts cache-relevant response headers
3. Headers are parsed into a structured breakdown:
- **Cache status** per layer (edge, durable cache, origin frameworks)
- **Cache-control** directives with TTL calculations
- **Served-by** detection (CDN edge, durable cache, function, edge function)
4. Results are persisted so runs can be shared via permalink
## Deployment
This site deploys automatically to Netlify.
## Tech stack
- [Nuxt 5](https://nuxt.com) (Vue 3, file-based routing, server API routes)
- [UnoCSS](https://unocss.dev) (utility CSS, dark mode, custom theme)
- [Netlify Blobs](https://docs.netlify.com/blobs/overview/) (run persistence)
- [Vitest](https://vitest.dev) + [Vue Test Utils](https://test-utils.vuejs.org) (testing)
## Contributing
You are absolutely welcome to contribute!
See [CONTRIBUTING.md](./CONTRIBUTING.md) for development workflow, testing, and code conventions.
## Architecture
See [ARCHITECTURE.md](./ARCHITECTURE.md) for project structure, data flow, and key design decisions.