Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Virtual Files tab is empty on Nuxt 5 / Nitro 3: /_vfs.json returns 404

Open
#1,127 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
3/5
Estimated time
Half a day
Newbie friendliness
42/100
Issue type
Bug
Clarity
Mostly clear
Activity status
Active
Tech stack
nuxtjs, typescript, vite
Domain
devtools, web-dev

Research direction

Start with the request path: the client fetch of /_vfs.json in the published @nuxt/devtools-assets utils bundle, and the dev-server route app.get("/_vfs/**", createVFSHandler(...)) in nitro/dist/_dev.mjs. Reproduce by hitting /_vfs/ with Accept: application/json on a running nuxt dev server. Done means the Virtual Files tab lists entries again; the issue leaves open whether the fix belongs in DevTools or Nitro, so confirm the side with maintainers first.

Written by the indexing model from the issue text.

Description

Environment
  • @nuxt/devtools 4.0.0-beta.5 (@nuxt/devtools-assets 4.0.0-beta.5)
  • nuxt 5.0.0-2610121449-e69fd4e (nuxt-nightly@5x)
  • nitro 3.0.260903-beta
  • Vite 8.3.4, Node.js 26.11.1, Windows 11
Reproduction
  1. Nuxt 5 nightly app with @nuxt/devtools 4 beta, nuxt dev
  2. Open DevTools, authorize the browser, open the "Virtual Files" tab
  3. The tab stays empty; the dev server logs GET /_vfs.json 404
Cause (as far as I can tell)

The client fetches the file list from /_vfs.json (published bundle: @nuxt/devtools-assets/dist/_nuxt/utils-k1kpr21p.js, $fetch('/_vfs.json', { baseURL: '/', responseType: 'json' })).

Nitro 3's dev server only registers app.get("/_vfs/**", createVFSHandler(this.nitro)) (nitro/dist/_dev.mjs). Checked with curl against the running dev server:

Request Status
GET /_vfs.json 404
GET /_vfs.json/<id> 404
GET /_vfs/ with Accept: application/json 200, JSON (rootDir, entries, current)
GET /_vfs/.json 200, JSON
GET /_vfs/<id> with Accept: application/json 200, JSON

Note that the JSON returned by Nitro 3 still lists entries[].path as /_vfs.json/<id>, which 404s as well. So this could be fixed on either side: DevTools requesting /_vfs/ with Accept: application/json (or /_vfs/.json), or Nitro registering the /_vfs.json/** route again. Happy to open the issue at nitrojs/nitro instead if that is the better place.

Dominant language
TypeScript
Stars
3.3k
Forks
218
Avg merge
1d 21h
Merged PRs (30d)
21

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from nuxt/devtools

All issues in nuxt/devtools

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.