FAQ

Does it work with output: "standalone"?

Yes. Generated PWA assets are written to public/, which is included in standalone output.

Does it work on Vercel?

Yes. Manifest and service worker files are static assets from public/ and work on Vercel without special routing changes.

Do I need HTTPS in production?

Yes. Service workers require HTTPS in production. localhost is exempt for local development.

Can I use my own manifest.webmanifest?

Yes. If public/manifest.json or public/manifest.webmanifest exists, values are merged on top of the auto-generated manifest.

Can I use my own offline page?

Yes. Add public/_offline.html. It will be used as the offline fallback.

Will API routes be cached?

By default, no. /api/* uses networkOnly and auth-related routes are excluded from caching for safety.

How can I test service workers in development?

Service workers are disabled by default in dev mode. To force-enable:

NEXT_PWA=1 next dev

How do I prompt users to update to a new version?

Use usePWAUpdate from next-pwa-auto/hooks and show an update UI when updateAvailable is true.

What icon format is recommended?

A 512x512 PNG is recommended. SVG also works.