<p align='center'>
    <picture>
        <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/vite-pwa/.github/main/unplugin-pwa-inspector-hero-dark.svg" />
        <img src="https://raw.githubusercontent.com/vite-pwa/.github/main/unplugin-pwa-inspector-hero.svg" alt="Inspector UI for unplugin-pwa logo">
    </picture>
</p>

<h1 align="center">Inspect and debug your PWA during development</h1>

<p align='center'>
<a href='https://npmx.dev/package/@unplugin-pwa/inspector' target="_blank" rel="noopener noreferrer">
<img src='https://img.shields.io/npm/v/@unplugin-pwa/inspector?color=33A6B8&label=' alt="NPM version">
</a>
<a href="https://npmx.dev/package/@unplugin-pwa/inspector" target="_blank" rel="noopener noreferrer">
    <img alt="NPM Downloads" src="https://img.shields.io/npm/dm/@unplugin-pwa/inspector?color=476582&label=">
</a>
<a href="https://unplugin-pwa.netlify.app/unplugin-pwa/inspector.html" target="_blank" rel="noopener noreferrer">
    <img src="https://img.shields.io/static/v1?label=&message=docs%20%26%20guides&color=2e859c" alt="Docs & Guides">
</a>
<br>
<a href="https://github.com/vite-pwa/unplugin-pwa" target="_blank" rel="noopener noreferrer">
<img alt="GitHub stars" src="https://img.shields.io/github/stars/vite-pwa/unplugin-pwa?style=social">
</a>
</p>

<br>

<p align="center">
  <a href="https://cdn.jsdelivr.net/gh/antfu/static/sponsors.svg">
    <img src="https://cdn.jsdelivr.net/gh/antfu/static/sponsors.svg" alt="Anthony Fu SVG sponsors image"/>
  </a>
</p>


## 🛠️ Welcome to unplugin-pwa/inspector

Visual inspector for the PWA generated by `unplugin-pwa`. Explore your resolved configuration, web manifest and service worker details from a clean GUI, without digging through terminal logs or triggering blind builds.

> 💡 **Note:** you normally don't need to install this package directly. It ships the inspector SPA as static files; `@unplugin-pwa/core` only exposes where its `dist` lives, and each integration (e.g. `@unplugin-pwa/vite`) serves it through a dev-server middleware or [DevFrame](https://github.com/devframes/devframe).

## ✨ Key Features

* 📦 **Configuration Explorer:** check exactly how your final PWA configuration has been resolved.
* 📱 **Web Manifest Preview:** inspect metadata, icons and colors as the browser will interpret them.
* ⚙️ **Service Worker Audit:** review caching strategies, precached routes and Workbox integration at a glance.
* 🖼️ **DevFrame Support:** compatible with [DevFrame](https://github.com/devframes/devframe) for a native DevTools experience.
* 🔌 **Standalone SPA:** a lightweight app distributed as static files, served by whichever integration you use.

## 📸 UI Sneak Peek

<br>

![Web Manifest at Vite Devtools](https://raw.githubusercontent.com/vite-pwa/.github/main/vite-devtools-manifest.png)

<br>

![Web Manifest Shortcuts at Vite Devtools](https://raw.githubusercontent.com/vite-pwa/.github/main/vite-devtools-manifest-shortcuts.png)

<br>

![Web Manifest Screenshots at Vite Devtools](https://raw.githubusercontent.com/vite-pwa/.github/main/vite-devtools-manifest-screenshots.png)

<br>

![Service Worker Info at Vite Devtools](https://raw.githubusercontent.com/vite-pwa/.github/main/vite-devtools-sw-info.png)

## 📄 License

[MIT](./LICENSE) License &copy; 2026-PRESENT [Anthony Fu](https://github.com/antfu)