Website: the docs site's own service worker can't install (navigateFallback "/" isn't precached)
Nobody has claimed this yet.
Assessment
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Newbie friendliness
- 70/100
- Issue type
- Bug
- Clarity
- Clearly specified
- Activity status
- Active
- Tech stack
- javascript
- Domain
- devops, documentation
Research direction
Start by checking the built .output/public/sw.js and the docs site's @vite-pwa/nuxt configuration. Choose one of the proposed fixes: remove the PWA integration, or set registerType to autoUpdate and workbox.navigateFallback to null. Confirm the service worker installs in DevTools.
Written by the indexing model from the issue text.
Description
From the 2026-10-08 front-end review, checked in the built .output/public/sw.js.
sw.js registers NavigationRoute(createHandlerBoundToURL("/")), but / isn't in the precache manifest (only _payload.json files and _nuxt assets are). Workbox throws non-precached-url when the route is registered, so the worker fails to install. Our own PWA page warns readers about this exact navigateFallback trap.
If it did install, registerType defaults to 'prompt' and the site has no prompt UI, so new docs would wait until every tab is closed.
Fix. Either remove @vite-pwa/nuxt from the docs site (a docs site gains little from it), or set registerType: 'autoUpdate' and workbox.navigateFallback: null. Then confirm in DevTools that the worker installs.
- Dominant language
- Vue
- Stars
- 0
- Forks
- 0
- PR merge metrics
- No merged PRs in 30d
Getting set up
This project ships no dev container, Dockerfile or contributing guide, so setting up is up to you: start from its README, and see our first-contribution guide for the general steps.
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from components-web-app/docs
-
Website: the home page code samples use a broken import path and the non-recommended composableOpenbug
Difficulty 2/5 1-3 hours Newbie friendliness 82/100
components-web-app/docs#169 ·
-
bug
Difficulty 2/5 1-3 hours Newbie friendliness 78/100
components-web-app/docs#152 ·
-
Difficulty 3/5 1-2 days Newbie friendliness 58/100
components-web-app/docs#180 · 1 comment ·
-
enhancement
Difficulty 3/5 1-2 days Newbie friendliness 55/100
components-web-app/docs#179 ·
-
enhancement
Difficulty 4/5 3-5 days Newbie friendliness 48/100
components-web-app/docs#178 ·
All issues in components-web-app/docs
Similar issues
-
Bump .cicd to wamp-cicd 4c2f9ac: `just land` refuses open A18 decisions, `just where` lists themOpen
Difficulty 1/5 Under an hour Newbie friendliness 84/100
crossbario/txaio#241 ·
-
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
flathub/com.snes9x.Snes9x#129 ·
-
enhancement
Difficulty 2/5 1-3 hours Newbie friendliness 92/100
alunduil/projects-v2-sync#14 ·
-
`helios / deploy`: switch zone wait in `deploy.sh` has almost no headroom over healthy startup timesPossibly taken A pull request linked to this issue is open or already merged. OpenTest Flake
Difficulty 2/5 1-3 hours Newbie friendliness 74/100
oxidecomputer/omicron#11453 ·
Maintainers usually reply within 1 day
-
Difficulty 2/5 1-3 hours Newbie friendliness 74/100