Nuxt projects¶

The Nuxt adapter discovers routes from the pages/ directory and supports Nuxt-specific source mapping.

Support status¶

First-class integration for pages/ filesystem discovery.

framework: "nuxt" when Nuxt dependencies are detected.

Scans pages/ for route files similar to Nuxt conventions. When no pages are found, falls back to / with a diagnostic.

Dynamic segments may require routeDiscovery.samples:

routeDiscovery: {
  mode: "fallback",
  samples: {
    "/posts/[id]": ["/posts/1", "/posts/example"],
  },
},

Verify:

a11yst routes --explain

devServer: {
  command: "pnpm dev",
  url: "http://127.0.0.1:3000",
},

Nuxt 3 default port may differ — align url with your project.

Limitation	Detail
App config routes	Not all Nuxt routing features are inferred from files alone
Server routes	Audited only when reachable in browser at configured URLs
Hybrid with Vue guide	Use this Nuxt guide, not the Vue guide

Nuxt mapper resolves .vue and framework paths when build artifacts and indexes allow.