Nuxt · NUXT0050

Use NuxtLink for internal navigation

Finds Nuxt routing code that should use the supported NuxtLink pattern instead.
NUXT0050vite-doctor/nuxtroutingwarnAuto-fix

Run this rule

pnpm nuxt doctor --rules nuxt/routing/prefer-nuxtlink

Why it matters

NuxtLink handles client navigation, route prefetching, base paths, and external-link behavior for Nuxt applications.

Use <NuxtLink> for internal navigation.

Example

Before

<template>
  <a href="/dashboard">Dashboard</a>
</template>

After

<template>
  <NuxtLink to="/dashboard">Dashboard</NuxtLink>
</template>
Copyright © 2026